RoleProvider.AddUsersToRoles(String[], String[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет указанные имена пользователей в указанные роли для настроенного applicationName
.
public:
abstract void AddUsersToRoles(cli::array <System::String ^> ^ usernames, cli::array <System::String ^> ^ roleNames);
public abstract void AddUsersToRoles (string[] usernames, string[] roleNames);
abstract member AddUsersToRoles : string[] * string[] -> unit
Public MustOverride Sub AddUsersToRoles (usernames As String(), roleNames As String())
Параметры
- usernames
- String[]
Массив строк имен пользователей для добавления в указанные роли.
- roleNames
- String[]
Массив строк имен ролей, к которым добавляются указанные имена пользователей.
Примеры
В следующем примере кода показан пример реализации AddUsersToRoles метода .
public override void AddUsersToRoles(string[] usernames, string[] rolenames)
{
foreach (string rolename in rolenames)
{
if (rolename == null || rolename == "")
throw new ProviderException("Role name cannot be empty or null.");
if (!RoleExists(rolename))
throw new ProviderException("Role name not found.");
}
foreach (string username in usernames)
{
if (username == null || username == "")
throw new ProviderException("User name cannot be empty or null.");
if (username.Contains(","))
throw new ArgumentException("User names cannot contain commas.");
foreach (string rolename in rolenames)
{
if (IsUserInRole(username, rolename))
throw new ProviderException("User is already in role.");
}
}
OdbcConnection conn = new OdbcConnection(connectionString);
OdbcCommand cmd = new OdbcCommand("INSERT INTO UsersInRoles " +
" (Username, Rolename, ApplicationName) " +
" Values(?, ?, ?)", conn);
OdbcParameter userParm = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255);
OdbcParameter roleParm = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255);
cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;
try
{
conn.Open();
foreach (string username in usernames)
{
foreach (string rolename in rolenames)
{
userParm.Value = username;
roleParm.Value = rolename;
cmd.ExecuteNonQuery();
}
}
}
catch (OdbcException)
{
// Handle exception.
}
finally
{
conn.Close();
}
}
Public Overrides Sub AddUsersToRoles(usernames As String(), rolenames As String())
For Each rolename As String In rolenames
If rolename Is Nothing OrElse rolename = "" Then _
Throw New ProviderException("Role name cannot be empty or null.")
If Not RoleExists(rolename) Then _
Throw New ProviderException("Role name not found.")
Next
For Each username As String in usernames
If username Is Nothing OrElse username = "" Then _
Throw New ProviderException("User name cannot be empty or null.")
If username.Contains(",") Then _
Throw New ArgumentException("User names cannot contain commas.")
For Each rolename As String In rolenames
If IsUserInRole(username, rolename) Then
Throw New ProviderException("User is already in role.")
End If
Next
Next
Dim conn As OdbcConnection = New OdbcConnection(connectionString)
Dim cmd As OdbcCommand = New OdbcCommand("INSERT INTO UsersInRoles " & _
" (Username, Rolename, ApplicationName) " & _
" Values(?, ?, ?)", conn)
Dim userParm As OdbcParameter = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255)
Dim roleParm As OdbcParameter = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255)
cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName
Try
conn.Open()
For Each username As String In usernames
For Each rolename As String In rolenames
userParm.Value = username
roleParm.Value = rolename
cmd.ExecuteNonQuery()
Next
Next
Catch e As OdbcException
' Handle exception.
Finally
conn.Close()
End Try
End Sub
Комментарии
AddUsersToRoles вызывается классом Roles для связывания указанных пользователей с указанными ролями в источнике данных. Роли добавляются в настроенный ApplicationNameобъект .
Если какое-либо из указанных ролей не найдено для настроенного applicationName
, рекомендуется, чтобы поставщик выдал .ProviderException
Если любое из указанных имен пользователей не связано ни с каким из указанных имен ролей для настроенного applicationName
, рекомендуется, чтобы поставщик выдал .ProviderException
Если любое из указанных имен пользователей является null
или является пустой строкой, мы рекомендуем поставщику вызвать исключение.
Если какое-либо из указанных имен ролей является null
или является пустой строкой, мы рекомендуем поставщику вызвать исключение.
Если источник данных поддерживает транзакции, рекомендуется включать каждую операцию добавления в транзакцию и выполнять откат транзакции и создавать исключение в случае сбоя любой операции добавления.