SqlMembershipProvider Classe

Referência

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Gerencia o armazenamento de informações de associação de um aplicativo ASP.NET em um banco de dados do SQL Server.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider

public class SqlMembershipProvider : System.Web.Security.MembershipProvider

type SqlMembershipProvider = class
    inherit MembershipProvider

Public Class SqlMembershipProvider
Inherits MembershipProvider

Herança: Object

ProviderBase

MembershipProvider
SqlMembershipProvider

Exemplos

O exemplo de código a seguir mostra o arquivo Web.config para um aplicativo ASP.NET configurado para usar um SqlMembershipProvider.

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
  </connectionStrings>  
  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="login.aspx"  
        name=".ASPXFORMSAUTH" />  
    </authentication>  
    <authorization>  
      <deny users="?" />  
    </authorization>  
    <membership defaultProvider="SqlProvider"  
      userIsOnlineTimeWindow="15">  
      <providers>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>

Comentários

Observação

ASP.NET provedores de associação foram substituídos pelo ASP.NET Identity. É altamente recomendável atualizar aplicativos para usar a plataforma ASP.NET Identity em vez dos provedores de associação.

Essa classe é usada pelas Membership classes e MembershipUser para fornecer serviços de associação para um aplicativo ASP.NET usando um banco de dados do SQL Server. Você não pode usar um SqlMembershipProvider sem o SQL Server. Quando o computador tiver o SQL Server Express instalado com o nome da instância padrão e a instanciação do usuário habilitadas, o SqlMembershipProvider objeto criará um banco de dados chamado aspnetdb no diretório do App_Data aplicativo na primeira vez que o aplicativo for executado.

Para criar manualmente o banco de dados, execute o Aspnet_regsql.exe executável encontrado na %systemroot%\Microsoft.NET\Framework\ versionNumber pasta e especifique a opção -A m (por exemplo aspnet_regsql.exe -A m, ). O banco de dados criado é chamado de Aspnetdb. Como alternativa, execute Aspnet_regsql.exe para efetuar pull do modo de configuração da GUI e optar por configurar todos os recursos do ASP.NET.

Se o provedor de associação estiver configurado com uma cadeia de conexão que usa segurança integrada, a conta de processo do aplicativo ASP.NET deverá ter direitos para se conectar ao banco de dados do SQL Server.

O arquivo Machine.config define uma instância padrão SqlMembershipProvider chamada AspNetSqlMembershipProvider que se conecta à instância padrão do SQL Server Express no computador local. Você pode usar essa instância do provedor se tiver instalado o SQL Server Express com o nome da instância padrão ou definir sua própria instância no arquivo Web.config para seu aplicativo ASP.NET.

Se você definir o passwordCompatMode atributo como Framework40, o aplicativo poderá usar as opções de associação de hash e criptografia que foram adicionadas no ASP.NET 4. No entanto, se o passwordCompatMode atributo for definido Framework20como , somente as opções de associação de hash e criptografia do ASP.NET 2.0, ASP.NET 3.5 e ASP.NET 3.5 SP1 poderão ser usadas. O valor padrão é Framework20. Para obter mais informações, consulte MembershipPasswordCompatibilityMode.

Construtores

SqlMembershipProvider()

Inicializa uma nova instância da classe SqlMembershipProvider.

Propriedades

ApplicationName	Obtém ou define o nome do aplicativo do qual as informações de associação serão armazenadas e recuperadas.
Description	Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário). (Herdado de ProviderBase)
EnablePasswordReset	Obtém um valor que indica se o provedor de associação do SQL Server foi configurado para permitir que os usuários redefinam suas senhas.
EnablePasswordRetrieval	Obtém um valor que indica se o provedor de associação do SQL Server foi configurado para permitir que os usuários recuperem suas senhas.
MaxInvalidPasswordAttempts	Obtém o número de tentativas de senhas inválidas ou de respostas de senha permitidas antes do usuário associado ser bloqueado.
MinRequiredNonAlphanumericCharacters	Obtém o número mínimo de caracteres especiais que devem estar presentes em uma senha válida.
MinRequiredPasswordLength	Obtém o comprimento mínimo necessário para uma senha.
Name	Obtém o nome amigável usado para referir-se ao provedor durante a configuração. (Herdado de ProviderBase)
PasswordAttemptWindow	Obtém a janela de tempo entre a qual as tentativas com falha consecutivas de fornecer uma senha ou uma resposta de senha válida são rastreadas.
PasswordFormat	Obtém um valor que indica o formato para armazenar as senhas no banco de dados de associação SQL Server.
PasswordStrengthRegularExpression	Obtém a expressão regular usada para avaliar uma senha.
RequiresQuestionAndAnswer	Obtém um valor que indica se o provedor de associação do SQL Server está configurado para exigir que o usuário responda a uma pergunta de senha para recuperação e redefinição de senha.
RequiresUniqueEmail	Obtém um valor que indica se o provedor de associação do SQL Server está configurado para exigir um endereço de email exclusivo para cada nome de usuário.

Métodos

ChangePassword(String, String, String)	Modifica a senha de um usuário.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Atualiza a pergunta e resposta da senha do usuário no banco de dados de associação do SQL Server.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Adiciona um novo usuário ao banco de dados de associação do SQL Server.
DecryptPassword(Byte[])	Descriptografa uma senha criptografada. (Herdado de MembershipProvider)
DeleteUser(String, Boolean)	Remove as informações de associação de um usuário do banco de dados de associação do SQL Server.
EncryptPassword(Byte[])	Criptografa uma senha. (Herdado de MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Criptografa a senha especificada usando o modo de compatibilidade de senha especificado. (Herdado de MembershipProvider)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Retorna uma coleção de usuários associados na qual o campo de endereço de email contém o endereço de email especificado.
FindUsersByName(String, Int32, Int32, Int32)	Obtém uma coleção de usuários associados em que o nome de usuário contém o nome de usuário especificado para corresponder.
GeneratePassword()	Gera uma senha aleatória com no mínimo 14 caracteres.
GetAllUsers(Int32, Int32, Int32)	Obtém uma coleção de todos os usuários no banco de dados de associação do SQL Server.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetNumberOfUsersOnline()	Retorna o número de usuários que estão acessando o aplicativo no momento.
GetPassword(String, String)	Retorna a senha para o nome de usuário especificado do banco de dados de associação do SQL Server.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUser(Object, Boolean)	Obtém as informações da fonte de dados do usuário associado relacionadas ao identificador exclusivo especificado e atualiza o carimbo de data/hora da atividade mais recente do usuário, se indicado.
GetUser(String, Boolean)	Retorna informações do banco de dados de associação SQL Server para um usuário e fornece uma opção para atualizar o último carimbo de data/hora de atividade do usuário.
GetUserNameByEmail(String)	Obtém o nome de usuário associado ao endereço de email especificado.
Initialize(String, NameValueCollection)	Inicializa o provedor de associação do SQL Server com os valores de propriedade especificados no arquivo de configuração do aplicativo ASP.NET. Esse método não se destina a ser usado diretamente do seu código.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Gerará o evento ValidatingPassword se um manipulador de eventos tiver sido definido. (Herdado de MembershipProvider)
ResetPassword(String, String)	Redefine a senha de um usuário com uma nova senha gerada automaticamente.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UnlockUser(String)	Limpa o estado bloqueado do usuário para que o usuário associado possa ser validado.
UpdateUser(MembershipUser)	Atualiza informações sobre um usuário no banco de dados de associação SQL Server.
ValidateUser(String, String)	Verifica se o nome de usuário e a senha especificados existem no banco de dados de associação SQL Server.

Eventos

ValidatingPassword

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

(Herdado de MembershipProvider)

Aplica-se a

Confira também

Introdução à associação de ASP.NET

Partilhar via