RoleProvider.AddUsersToRoles(String[], String[]) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till de angivna användarnamnen i de angivna rollerna för den konfigurerade 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())
Parametrar
- usernames
- String[]
En strängmatris med användarnamn som ska läggas till i de angivna rollerna.
- roleNames
- String[]
En strängmatris med rollnamnen som de angivna användarnamnen ska läggas till i.
Exempel
I följande kodexempel visas en exempelimplementering av AddUsersToRoles metoden.
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
Kommentarer
AddUsersToRoles anropas av Roles klassen för att associera de angivna användarna med de angivna rollerna i datakällan. Roller läggs till i den konfigurerade ApplicationName.
Om något av de angivna rollnamnen inte hittas för den konfigurerade applicationNamerekommenderar vi att providern genererar en ProviderException.
Om något av de angivna användarnamnen inte är associerade med något av de angivna rollnamnen för den konfigurerade applicationNamerekommenderar vi att providern genererar en ProviderException.
Om något av de angivna användarnamnen är null eller är en tom sträng rekommenderar vi att leverantören utlöser ett undantag.
Om något av de angivna rollnamnen är null eller är en tom sträng rekommenderar vi att providern genererar ett undantag.
Om datakällan stöder transaktioner rekommenderar vi att du inkluderar varje tilläggsåtgärd i en transaktion och att du återställer transaktionen och utlöser ett undantag om någon tilläggsåtgärd misslyckas.