RoleProvider.AddUsersToRoles(String[], String[]) Methode

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Fügt die angegebenen Benutzernamen den angegebenen Rollen der konfigurierten applicationName hinzu.

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())

Parameter

usernames

String[]

Ein Zeichenfolgenarray mit Benutzernamen, die den angegebenen Rollen hinzugefügt werden sollen.

roleNames

String[]

Ein Zeichenfolgenarray mit Rollennamen, denen die angegebenen Benutzernamen hinzugefügt werden sollen.

Beispiele

Das folgende Codebeispiel zeigt eine Beispielimplementierung der AddUsersToRoles -Methode.

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

Hinweise

AddUsersToRoles wird von der Roles -Klasse aufgerufen, um die angegebenen Benutzer den angegebenen Rollen in der Datenquelle zuzuordnen. Rollen werden dem konfigurierten ApplicationNamehinzugefügt.

Wenn einer der angegebenen Rollennamen für die konfigurierte applicationNamenicht gefunden wird, wird empfohlen, dass Ihr Anbieter eine ProviderExceptionauslöst.

Wenn einer der angegebenen Benutzernamen keinem der angegebenen Rollennamen für den konfigurierten applicationNamezugeordnet ist, wird empfohlen, dass Ihr Anbieter eine ProviderExceptionauslöst.

Wenn einer der angegebenen Benutzernamen eine leere Zeichenfolge ist null oder ist, wird empfohlen, dass Ihr Anbieter eine Ausnahme auslöst.

Wenn einer der angegebenen Rollennamen eine leere Zeichenfolge ist null oder ist, wird empfohlen, dass Ihr Anbieter eine Ausnahme auslöst.

Wenn Ihre Datenquelle Transaktionen unterstützt, empfiehlt es sich, jeden Add-Vorgang in eine Transaktion aufzunehmen und ein Rollback für die Transaktion durchzuführen und eine Ausnahme zu auslösen, wenn ein Add-Vorgang fehlschlägt.

Weitere Informationen

• Implementieren eines Rollenanbieters