RoleProvider.AddUsersToRoles(String[], String[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute les noms d’utilisateurs spécifiés aux rôles spécifiés pour le applicationName
configuré.
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())
Paramètres
- usernames
- String[]
Tableau de chaînes contenant les noms d’utilisateurs à ajouter aux rôles spécifiés.
- roleNames
- String[]
Tableau de chaînes contenant les noms des rôles auxquels ajouter les noms d’utilisateurs spécifiés.
Exemples
L’exemple de code suivant montre un exemple d’implémentation de la AddUsersToRoles méthode .
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
Remarques
AddUsersToRoles est appelé par la Roles classe pour associer les utilisateurs spécifiés aux rôles spécifiés au niveau de la source de données. Les rôles sont ajoutés au configuré ApplicationName.
Si l’un des noms de rôle spécifiés est introuvable pour le configuré applicationName
, nous vous recommandons de lever un ProviderException.
Si l’un des noms d’utilisateur spécifiés n’est associé à aucun des noms de rôle spécifiés pour le configuré applicationName
, nous vous recommandons de lever un ProviderException.
Si l’un des noms d’utilisateur spécifiés est null
ou est une chaîne vide, nous vous recommandons de lever une exception.
Si l’un des noms de rôle spécifiés est null
ou est une chaîne vide, nous vous recommandons de lever une exception.
Si votre source de données prend en charge les transactions, nous vous recommandons d’inclure chaque opération d’ajout dans une transaction et de restaurer la transaction et de lever une exception en cas d’échec d’une opération d’ajout.