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

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Aggiunge i nomi utente specificati ai ruoli indicati per l'oggetto applicationName configurato.

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

Parametri

usernames

String[]

Matrice di stringhe di nomi utente da aggiungere ai ruoli specificati.

roleNames

String[]

Matrice di stringhe di nomi di ruoli a cui aggiungere i nomi utente specificati.

Esempio

Nell'esempio di codice seguente viene illustrata un'implementazione di esempio del AddUsersToRoles metodo.

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

Commenti

AddUsersToRoles viene chiamato dalla Roles classe per associare gli utenti specificati ai ruoli specificati nell'origine dati. I ruoli vengono aggiunti all'oggetto configurato ApplicationName.

Se uno dei nomi di ruolo specificati non viene trovato per l'oggetto configurato, è consigliabile applicationNameche il provider generi un ProviderExceptionoggetto .

Se uno dei nomi utente specificati non è associato a uno dei nomi di ruolo specificati per la configurazione applicationName, è consigliabile che il provider generi un ProviderExceptionoggetto .

Se uno dei nomi utente specificati è o è null una stringa vuota, è consigliabile generare un'eccezione.

Se uno dei nomi di ruolo specificati è o è null una stringa vuota, è consigliabile generare un'eccezione.

Se l'origine dati supporta le transazioni, è consigliabile includere ogni operazione di aggiunta in una transazione e eseguire il rollback della transazione e generare un'eccezione se un'operazione di aggiunta ha esito negativo.

Vedi anche

• Implementazione di un provider di ruoli