RoleProvider.AddUsersToRoles(String[], String[]) Método

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll
Assemblagem:
System.Web.ApplicationServices.dll

Adiciona os nomes de utilizador especificados aos papéis especificados para o .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())

Parâmetros

usernames
String[]

Um conjunto de nomes de utilizador a serem adicionados aos papéis especificados.

roleNames
String[]

Uma matriz de cadeias com os nomes dos papéis para adicionar os nomes de utilizador especificados.

Exemplos

O exemplo de código seguinte mostra uma implementação exemplar do AddUsersToRoles método.

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

Observações

AddUsersToRoles é chamada pela Roles classe para associar os utilizadores especificados aos papéis especificados na fonte de dados. Os papéis são adicionados ao .ApplicationName

Se nenhum dos nomes de papéis especificados for encontrado para a configuração applicationName, recomendamos que o seu fornecedor lance um ProviderExceptionarquivo .

Se algum dos nomes de utilizador especificados não estiver associado a nenhum dos nomes de papéis especificados para o configurado applicationName, recomendamos que o seu fornecedor faça um ProviderExceptionarquivo .

Se algum dos nomes de utilizador especificados for null ou for uma cadeia vazia, recomendamos que o seu fornecedor faça uma exceção.

Se algum dos nomes de funções especificados for null ou for uma cadeia vazia, recomendamos que o seu fornecedor faça uma exceção.

Se a sua fonte de dados suportar transações, recomendamos que inclua cada operação de adição numa transação e que reverta a transação e lance uma exceção caso alguma operação de adição falhe.

Aplica-se a

Ver também