Membership Classe
TOC
Recolher sumário
Expandir sumário
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Membership

 

Valida as credenciais do usuário e gerencia as configurações do usuário. Essa classe não pode ser herdada.

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

System.Object
  System.Web.Security.Membership

public static class Membership

NomeDescrição
System_CAPS_pubpropertySystem_CAPS_staticApplicationName

Obtém ou define o nome do aplicativo.

System_CAPS_pubpropertySystem_CAPS_staticEnablePasswordReset

Obtém um valor que indica se o provedor de associação atual está configurado para permitir que os usuários redefinam suas senhas.

System_CAPS_pubpropertySystem_CAPS_staticEnablePasswordRetrieval

Obtém um valor que indica se o provedor de associação atual está configurado para permitir que os usuários recuperem suas senhas.

System_CAPS_pubpropertySystem_CAPS_staticHashAlgorithmType

O identificador do algoritmo usado para aplicar hash em senhas.

System_CAPS_pubpropertySystem_CAPS_staticMaxInvalidPasswordAttempts

Obtém o número de senhas ou de resposta de senha inválidas permitidas antes do usuário da associação é bloqueado.

System_CAPS_pubpropertySystem_CAPS_staticMinRequiredNonAlphanumericCharacters

Obtém o número mínimo de caracteres especiais que devem estar presentes em uma senha válida.

System_CAPS_pubpropertySystem_CAPS_staticMinRequiredPasswordLength

Obtém o comprimento mínimo necessário para uma senha.

System_CAPS_pubpropertySystem_CAPS_staticPasswordAttemptWindow

Obtém a janela de tempo entre os quais consecutivas tentativas para fornecer uma senha válida ou a resposta de senha é rastreadas.

System_CAPS_pubpropertySystem_CAPS_staticPasswordStrengthRegularExpression

Obtém a expressão regular usada para avaliar uma senha.

System_CAPS_pubpropertySystem_CAPS_staticProvider

Obtém uma referência ao provedor de associação padrão para o aplicativo.

System_CAPS_pubpropertySystem_CAPS_staticProviders

Obtém uma coleção de provedores de associação para o aplicativo ASP.NET.

System_CAPS_pubpropertySystem_CAPS_staticRequiresQuestionAndAnswer

Obtém um valor que indica se o provedor de associação padrão exige que o usuário responder a uma pergunta de senha de redefinição de senha e a recuperação.

System_CAPS_pubpropertySystem_CAPS_staticUserIsOnlineTimeWindow

Especifica o número de minutos após a última atividade carimbo para um usuário durante o qual o usuário é considerado online de data/hora.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticCreateUser(String, String)

Adiciona um novo usuário para o armazenamento de dados.

System_CAPS_pubmethodSystem_CAPS_staticCreateUser(String, String, String)

Adiciona um novo usuário com um endereço de email especificado para o armazenamento de dados.

System_CAPS_pubmethodSystem_CAPS_staticCreateUser(String, String, String, String, String, Boolean, MembershipCreateStatus)

Adiciona um novo usuário com valores de propriedade especificado para o armazenamento de dados e retorna um parâmetro de status indicando que o usuário foi criado com êxito ou falha de criação de usuário o motivo.

System_CAPS_pubmethodSystem_CAPS_staticCreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Adiciona um novo usuário com valores de propriedade especificado e um identificador exclusivo para o armazenamento de dados e retorna um parâmetro de status indicando que o usuário foi criado com êxito ou falha de criação de usuário o motivo.

System_CAPS_pubmethodSystem_CAPS_staticDeleteUser(String)

Exclui um usuário e os dados de usuário relacionado do banco de dados.

System_CAPS_pubmethodSystem_CAPS_staticDeleteUser(String, Boolean)

Exclui um usuário do banco de dados.

System_CAPS_pubmethodSystem_CAPS_staticFindUsersByEmail(String)

Obtém uma coleção de usuários da associação onde o endereço de email contém o endereço de email especificado para corresponder.

System_CAPS_pubmethodSystem_CAPS_staticFindUsersByEmail(String, Int32, Int32, Int32)

Obtém uma coleção de usuários de associação em uma página de dados, onde o endereço de email contém o endereço de email especificado para corresponder.

System_CAPS_pubmethodSystem_CAPS_staticFindUsersByName(String)

Obtém uma coleção de usuários da associação onde o nome de usuário contém o nome de usuário especificado para corresponder.

System_CAPS_pubmethodSystem_CAPS_staticFindUsersByName(String, Int32, Int32, Int32)

Obtém uma coleção de usuários de associação em uma página de dados, onde o nome de usuário contém o nome de usuário especificado para corresponder.

System_CAPS_pubmethodSystem_CAPS_staticGeneratePassword(Int32, Int32)

Gera uma senha aleatória do comprimento especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetAllUsers()

Obtém uma coleção de todos os usuários no banco de dados.

System_CAPS_pubmethodSystem_CAPS_staticGetAllUsers(Int32, Int32, Int32)

Obtém uma coleção de todos os usuários no banco de dados em páginas de dados.

System_CAPS_pubmethodSystem_CAPS_staticGetNumberOfUsersOnline()

Obtém o número de usuários atualmente acessando um aplicativo.

System_CAPS_pubmethodSystem_CAPS_staticGetUser()

Obtém as informações da fonte de dados e atualiza o carimbo de data/hora da última atividade para o usuário do membership logado atualmente.

System_CAPS_pubmethodSystem_CAPS_staticGetUser(Boolean)

Obtém as informações da fonte de dados para o usuário do membership logado. Carimbo de data/hora de atualizações a última atividade do usuário da associação de logon atual, se especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetUser(Object)

Obtém as informações da fonte de dados do usuário do membership associado com o identificador exclusivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetUser(Object, Boolean)

Obtém as informações da fonte de dados do usuário do membership associado com o identificador exclusivo especificado. Carimbo de data/hora de atualizações a última atividade do usuário, se especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetUser(String)

Obtém as informações da fonte de dados para o usuário do membership especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetUser(String, Boolean)

Obtém as informações da fonte de dados para o usuário do membership especificado. Carimbo de data/hora de atualizações a última atividade do usuário, se especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetUserNameByEmail(String)

Obtém um nome de usuário em que o endereço de email para o usuário corresponde ao endereço de email especificado.

System_CAPS_pubmethodSystem_CAPS_staticUpdateUser(MembershipUser)

Atualiza o banco de dados com as informações para o usuário especificado.

System_CAPS_pubmethodSystem_CAPS_staticValidateUser(String, String)

Verifica se o nome de usuário fornecido e senha são válidos.

NomeDescrição
System_CAPS_pubeventSystem_CAPS_staticValidatingPassword

Ocorre quando um usuário é criado, uma senha é alterada ou uma senha é redefinida.

O Membership em aplicativos ASP.NET, a classe é usada para validar as credenciais do usuário e gerenciar configurações de usuário, como senhas e endereços de email. O Membership classe pode ser usada sozinha ou em conjunto com o FormsAuthentication para criar um sistema completo para autenticar usuários de um aplicativo Web ou site. O Login controle encapsula o Membership classe para fornecer um mecanismo conveniente para validar usuários.

System_CAPS_noteObservação

Se você não estiver familiarizado com os recursos de associação do ASP.NET, consulte Introduction to Membership antes de continuar. Para obter uma lista de outros tópicos relacionados a associação, consulte Managing Users by Using Membership.

O Membership classe fornece recursos para:

  • Criar novos usuários.

  • Armazenar informações de associação (nomes de usuário, senhas, endereços de email e dados de suporte) no Microsoft SQL Server ou em um armazenamento de dados alternativo.

  • Autenticar usuários que visitam seu site. Você pode autenticar os usuários programaticamente ou você pode usar o Login controle para criar um sistema de autenticação completa que requer pouco ou nenhum código.

  • Gerenciamento de senhas, que inclui criar, alterar, recuperando e redefini-las e assim por diante. Opcionalmente, você pode configurar a associação ASP.NET para exigir uma senha pergunta e resposta para autenticar solicitações de recuperação ou redefinição de senha para usuários que esqueceram suas senhas.

Embora a associação do ASP.NET é um recurso independentes do ASP.NET para autenticação, ele pode ser integrado com o gerenciamento de função ASP.NET para fornecer serviços de autorização para seu site. Associação também pode ser integrada com o usuário do ASP.NET System.Web.Profile para fornecer personalização específica do aplicativo que pode ser adaptada para usuários individuais. Para obter detalhes, consulte Understanding Role Management e ASP.NET Profile Properties Overview.

O Membership classe depende de provedores de associação para se comunicar com uma fonte de dados. O .NET Framework inclui um SqlMembershipProvider, que armazena informações de usuário em um banco de dados do Microsoft SQL Server e um ActiveDirectoryMembershipProvider, que permite que você armazene informações de usuário em um servidor do Active Directory ou aplicativo modo ADAM (Active Directory). Você também pode implementar um provedor de associação personalizado para se comunicar com uma fonte de dados alternativo que pode ser usada pelo Membership classe. Provedores de associação personalizado herdam o MembershipProvider classe abstrata. Para obter mais informações, consulte Implementing a Membership Provider.

Por padrão, a associação do ASP.NET é habilitada para todos os aplicativos ASP.NET. O provedor de associação padrão é o SqlMembershipProvider e é especificado na configuração do computador com o nome AspNetSqlProvider. A instância padrão do SqlMembershipProvider está configurado para se conectar a uma instância local do Microsoft SQL Server.

Você pode modificar as configurações padrão para especificar um SqlMembershipProvider que o AspNetSqlProvider a instância como o provedor padrão ou especificar uma instância de um provedor personalizado como o provedor padrão para seu aplicativo ASP.NET usando o arquivo Web. config. Você pode especificar a configuração de associação do ASP.NET para o aplicativo Web usando a seção de configuração no arquivo Web. config. Você pode usar o providers a subseção para especificar um provedor de associação que não seja um dos provedores padrão. Por exemplo, a seção a seguir remove os provedores de associação padrão da configuração de aplicativo atual e adiciona um novo provedor com um nome de SqlProvider que se conecta a uma instância do SQL Server chamada AspSqlServer.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=AspSqlServer;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>
  <system.web>
    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
      <providers>
        <remove name="AspNetSqlProvider" />
        <add name="SqlProvider"
          type="System.Web.Security.SqlMembershipProvider"
          connectionStringName="SqlServices"
          enablePasswordRetrieval="false"
          enablePasswordReset="true"
          requiresQuestionAndAnswer="true"
          passwordFormat="Hashed"
          applicationName="/" />
      </providers>
    </membership>
  </system.web>
</configuration>

O exemplo de código a seguir mostra a página de logon para um aplicativo ASP.NET configurado para usar autenticação de formulários e associação do ASP.NET. Se as credenciais de usuário fornecidas são inválidas, será exibida uma mensagem para o usuário. Caso contrário, o usuário é redirecionado para a URL solicitada originalmente usando o RedirectFromLoginPage método.

System_CAPS_noteObservação

Os controles de login ASP.NET (Login, LoginView, LoginStatus, LoginName, e PasswordRecovery) encapsulam praticamente toda a lógica necessária para solicitar aos usuários credenciais e validar as credenciais no sistema de associação e pode ser usado em vez de usar verificação programático a Membership classe.

System_CAPS_security Segurança Observação

Este exemplo contem uma caixa de texto que aceita entradas do usuário, que é uma potencial ameaça de segurança. Por padrão, páginas da Web ASP.NET validam a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Script Exploits Overview.

<%@ 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">

public void Login_OnClick(object sender, EventArgs args)
{
   if (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text))
      FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked);
   else
     Msg.Text = "Login failed. Please check your user name and password and try again.";
}


</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
  <title>Login</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Login</h3>

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

  Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
  Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />

  <asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
  <asp:CheckBox id="NotPublicCheckBox" runat="server" /> 
  Check here if this is <span style="text-decoration:underline">not</span> a public computer.

</form>

</body>
</html>

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar:
© 2016 Microsoft