RoleProvider.GetUsersInRole(String) Método

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.ApplicationServices.dll

Obtiene una lista de usuarios incluidos en el rol especificado para el elemento applicationName configurado.

public:
 abstract cli::array <System::String ^> ^ GetUsersInRole(System::String ^ roleName);

public abstract string[] GetUsersInRole (string roleName);

abstract member GetUsersInRole : string -> string[]

Public MustOverride Function GetUsersInRole (roleName As String) As String()

Parámetros

roleName

String

Nombre del rol para el que se obtendrá la lista de usuarios.

Devoluciones

String[]

Matriz de cadenas que contiene los nombres de todos los usuarios que son miembros del rol especificado para el elemento applicationName configurado.

Ejemplos

En el ejemplo de código siguiente se muestra una implementación de ejemplo del GetUsersInRole método .

public override string[] GetUsersInRole(string rolename)
{
  if (rolename == null || rolename == "")
    throw new ProviderException("Role name cannot be empty or null.");
  if (!RoleExists(rolename))
    throw new ProviderException("Role does not exist.");

  string tmpUserNames = "";

  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("SELECT Username FROM UsersInRoles "  +
                                    " WHERE Rolename = ? AND ApplicationName = ?", conn);

  cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename;
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;

  OdbcDataReader reader = null;

  try
  {
    conn.Open();

    reader = cmd.ExecuteReader();

    while (reader.Read())
    {
      tmpUserNames += reader.GetString(0) + ",";
    }
  }
  catch (OdbcException)
  {
    // Handle exception.
  }
  finally
  {
    if (reader != null) { reader.Close(); }
    conn.Close();      
  }

  if (tmpUserNames.Length > 0)
  {
    // Remove trailing comma.
    tmpUserNames = tmpUserNames.Substring(0, tmpUserNames.Length - 1);
    return tmpUserNames.Split(',');
  }

  return new string[0];
}

Public Overrides Function GetUsersInRole(ByVal rolename As String) As String()
    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 does not exist.")

    Dim tmpUserNames As String = ""

    Dim conn As OdbcConnection = New OdbcConnection(connectionString)
    Dim cmd As OdbcCommand = New OdbcCommand("SELECT Username FROM UsersInRoles " & _
                                             " WHERE Rolename = ? AND ApplicationName = ?", conn)

    cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename
    cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName

    Dim reader As OdbcDataReader = Nothing

    Try
        conn.Open()

        reader = cmd.ExecuteReader()

        Do While reader.Read()
            tmpUserNames &= reader.GetString(0) + ","
        Loop
    Catch e As OdbcException
        ' Handle exception.
    Finally
        If Not reader Is Nothing Then reader.Close()
        conn.Close()
    End Try

    If tmpUserNames.Length > 0 Then
        ' Remove trailing comma.
        tmpUserNames = tmpUserNames.Substring(0, tmpUserNames.Length - 1)
        Return tmpUserNames.Split(CChar(","))
    End If

    Return New String() {}
End Function

Comentarios

GetUsersInRole lo llama el GetUsersInRole método de la Roles clase para recuperar los nombres de usuario asociados a un rol del origen de datos. Solo se recuperan los roles para el configurado ApplicationName .

Si el nombre de rol especificado no existe para el configurado applicationName o si es null o una cadena vacía, se recomienda que el proveedor produzca una excepción.

Si ningún usuario está asociado al rol especificado para el configurado applicationName, se recomienda que el proveedor devuelva una matriz de cadenas sin elementos.

Consulte también

• Implementar un proveedor de roles