SqlMembershipProvider Classe
Definição
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::MembershipProviderpublic class SqlMembershipProvider : System.Web.Security.MembershipProvidertype SqlMembershipProvider = class
inherit MembershipProviderPublic Class SqlMembershipProvider
Inherits MembershipProvider- Herança
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 SQL Server. Você não pode usar um SqlMembershipProvider sem SQL Server. Quando o computador tiver 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 SQL Server.
O arquivo Machine.config define uma instância padrão SqlMembershipProvider chamada AspNetSqlMembershipProvider que se conecta à instância de SQL Server Express padrão no computador local. Você pode usar essa instância do provedor se tiver instalado 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de