Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Método AuthorizationStoreRoleProvider.GetRolesForUser

.NET Framework 4.5

Outras versões

Obtém uma lista das funções do usuário.

Namespace: System.Web.Security
Assembly: System.Web (em System.Web.dll)

Sintaxe

C++

public override string[] GetRolesForUser(
	string username
)

Parâmetros

username: Tipo: System.String
Para retornar uma lista de funções para o usuário.

Valor de retorno

Tipo: System.String[]
Uma matriz de cadeia de caracteres que contém os nomes de todas as funções que o usuário especificado está em.

Exceções

Exceção	Condição
ArgumentNullException	username é null.
ArgumentException	usernamecontém uma vírgula.
ProviderException	Configurados applicationName não foi encontrado. -ou- Configurados scopeName não foi encontrado. -ou- O tempo de execução do Gerenciador de autorização não está instalado no servidor.
FileNotFoundException	O connectionStringName atributo faz referência a uma seqüência de conexão para um arquivo que não existe.
HttpException	O AuthorizationStoreRoleProvider instância está configurada com um armazenamento de diretiva baseada em arquivo e acesso de leitura ao arquivo não é permitido no nível de confiança atual.

Comentários

O GetRolesForUser método é chamado pelo Roles classe para recuperar uma lista de funções do usuário especificado do armazenamento de diretivas do Gerenciador de autorização especificado na página ASP.NET do arquivo de configuração do aplicativo (Web. config).

Exemplos

O seguinte exemplo de código usa a GetRolesForUser método para recuperar uma lista de funções de um usuário específico e vincula-los para um System.Web.UI.WebControls.GridView controle. Para obter um exemplo de um arquivo Web. config que permite o gerenciamento de função, consulte AuthorizationStoreRoleProvider.


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

string[] rolesArray;
MembershipUserCollection users;

public void Page_Load()
{
  Msg.Text = "";

  try
  {
    if (!Roles.IsUserInRole(User.Identity.Name, "Administrators"))
    {
      Msg.Text = "You are not authorized to view user roles.";
      UsersListBox.Visible = false;
      return;
    }
  }
  catch (HttpException e)
  {
    Msg.Text = "There is no current logged on user. Role membership cannot be verified.";
    return;
  }


  if (!IsPostBack)
  {
    // Bind users to ListBox.

    users = Membership.GetAllUsers();
    UsersListBox.DataSource = users;
    UsersListBox.DataBind();
  }


  // If a user is selected, show the roles for the selected user.

  if (UsersListBox.SelectedItem != null)
  {
    // Bind roles to GridView.

    rolesArray = Roles.GetRolesForUser(UsersListBox.SelectedItem.Value);
    UserRolesGrid.DataSource = rolesArray;
    UserRolesGrid.DataBind();

    UserRolesGrid.Columns[0].HeaderText = "Roles for " + UsersListBox.SelectedItem.Value;
  }
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: View User Roles</title>
</head>
<body>

<form runat="server" id="PageForm">

  <h3>View User Roles</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  <table border="0" cellspacing="4">
    <tr>
      <td valign="top"><asp:ListBox id="UsersListBox" DataTextField="Username" 
                                    Rows="8" AutoPostBack="true" runat="server" /></td>
      <td valign="top"><asp:GridView runat="server" CellPadding="4" id="UserRolesGrid" 
                                     AutoGenerateColumns="false" Gridlines="None" 
                                     CellSpacing="0" >
                         <HeaderStyle BackColor="navy" ForeColor="white" />
                         <Columns>
                           <asp:TemplateField HeaderText="Roles" >
                             <ItemTemplate>
                               <%# Container.DataItem.ToString() %>
                             </ItemTemplate>
                           </asp:TemplateField>
                         </Columns>
                       </asp:GridView></td>
    </tr>
  </table>

</form>

</body>
</html>

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também

Referência

AuthorizationStoreRoleProvider Classe

Namespace System.Web.Security

Outros recursos

Understanding ASP.NET Role Management

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR