MembershipProvider Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define o contrato que o ASP.NET implementa para fornecer serviços de adesão utilizando fornecedores de adesão personalizados.
public ref class MembershipProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class MembershipProvider : System.Configuration.Provider.ProviderBasetype MembershipProvider = class
inherit ProviderBasePublic MustInherit Class MembershipProvider
Inherits ProviderBase- Herança
- Derivado
Observações
Note
ASP.NET fornecedores de adesão foram substituídos pelo ASP.NET Identity. Recomendamos vivamente a atualização das aplicações para utilizarem a plataforma ASP.NET Identity em vez dos fornecedores de membros.
A adesão ao ASP.NET foi concebida para lhe permitir utilizar facilmente vários fornecedores de adesão diferentes para as suas aplicações ASP.NET. Pode usar os fornecedores de subscrição fornecidos que vêm incluídos no .NET Framework, ou pode implementar o seu próprio fornecedor.
Note
Se não estiver familiarizado com as funcionalidades de adesão do ASP.NET, consulte Introdução à Adesão antes de continuar. Para uma lista de outros tópicos relacionados com a adesão, veja Gerir Utilizadores através do Uso da Adesão.
Ao implementar um fornecedor de subscrição personalizado, é obrigado a herdar a MembershipProvider classe abstrata.
Existem duas razões principais para criar um fornecedor de subscrição personalizado.
É necessário armazenar a informação de membros numa fonte de dados que não seja suportada pelos fornecedores de membros incluídos no .NET Framework, como uma base de dados FoxPro, uma base de dados Oracle ou outra fonte de dados.
É necessário gerir a informação de membros usando um esquema de base de dados diferente do esquema de base de dados usado pelos fornecedores que vêm com o .NET Framework. Um exemplo comum disto seriam os dados de membros que já existem numa base de dados SQL Server de uma empresa ou site.
A MembershipProvider classe abstrata herda da ProviderBase classe abstrata. MembershipProvider as implementações devem também implementar os membros necessários de ProviderBase.
Construtores
| Name | Description |
|---|---|
| MembershipProvider() |
Inicializa uma nova instância da MembershipProvider classe. |
Propriedades
| Name | Description |
|---|---|
| ApplicationName |
O nome da aplicação usando o fornecedor de subscrição personalizado. |
| Description |
Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs). (Herdado de ProviderBase) |
| EnablePasswordReset |
Indica se o fornecedor de membros está configurado para permitir que os utilizadores redefinam as suas palavras-passe. |
| EnablePasswordRetrieval |
Indica se o fornecedor de membros está configurado para permitir que os utilizadores recuperem as suas palavras-passe. |
| MaxInvalidPasswordAttempts |
Obtém o número de tentativas inválidas de palavra-passe ou de resposta por palavra-passe permitidas antes de o utilizador de subscrição ficar bloqueado. |
| MinRequiredNonAlphanumericCharacters |
Obtém o número mínimo de caracteres especiais que devem estar presentes numa palavra-passe válida. |
| MinRequiredPasswordLength |
Obtém o comprimento mínimo necessário para uma palavra-passe. |
| Name |
Recebe o nome amigável usado para se referir ao fornecedor durante a configuração. (Herdado de ProviderBase) |
| PasswordAttemptWindow |
Obtém o número de minutos em que é permitido um número máximo de tentativas inválidas de palavra-passe ou de resposta por palavra-passe antes de o utilizador de subscrição ser bloqueado. |
| PasswordFormat |
Recebe um valor que indica o formato para armazenar palavras-passe no armazenamento de dados de membros. |
| PasswordStrengthRegularExpression |
Obtém a expressão regular usada para avaliar uma palavra-passe. |
| RequiresQuestionAndAnswer |
Recebe um valor que indica se o fornecedor de membros está configurado para exigir que o utilizador responda a uma pergunta de palavra-passe para reposição e recuperação de palavra-passe. |
| RequiresUniqueEmail |
Recebe um valor que indica se o fornecedor de membros está configurado para exigir um endereço de email único para cada nome de utilizador. |
Métodos
| Name | Description |
|---|---|
| ChangePassword(String, String, String) |
Processa um pedido para atualizar a palavra-passe de um utilizador de membro. |
| ChangePasswordQuestionAndAnswer(String, String, String, String) |
Processa um pedido para atualizar a pergunta e resposta da palavra-passe para um utilizador de subscrição. |
| CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Adiciona um novo utilizador membro à fonte de dados. |
| DecryptPassword(Byte[]) |
Desencripta uma palavra-passe encriptada. |
| DeleteUser(String, Boolean) |
Remove um utilizador da fonte de dados de membros. |
| EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Encripta a palavra-passe especificada usando o modo de compatibilidade de palavra-passe especificado. |
| EncryptPassword(Byte[]) |
Encripta uma palavra-passe. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindUsersByEmail(String, Int32, Int32, Int32) |
Obtém uma coleção de utilizadores de membros onde o endereço de email contém o endereço especificado para corresponder. |
| FindUsersByName(String, Int32, Int32, Int32) |
Obtém uma coleção de utilizadores de membros onde o nome de utilizador contém o nome de utilizador especificado para corresponder. |
| GetAllUsers(Int32, Int32, Int32) |
Obtém uma coleção de todos os utilizadores na fonte de dados em páginas de dados. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetNumberOfUsersOnline() |
Obtém o número de utilizadores que estão a aceder à aplicação. |
| GetPassword(String, String) |
Obtém a palavra-passe do nome de utilizador especificado da fonte de dados. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUser(Object, Boolean) |
Obtém informações do utilizador a partir da fonte de dados com base no identificador único do utilizador de membros. Fornece uma opção para atualizar a data/hora da última atividade para o utilizador. |
| GetUser(String, Boolean) |
Obtém informação da fonte de dados do utilizador. Fornece uma opção para atualizar a data/hora da última atividade para o utilizador. |
| GetUserNameByEmail(String) |
Obtém o nome de utilizador associado ao endereço de email especificado. |
| Initialize(String, NameValueCollection) |
Inicializa o construtor de configuração. (Herdado de ProviderBase) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnValidatingPassword(ValidatePasswordEventArgs) |
Levanta o ValidatingPassword evento se um gestor de eventos tiver sido definido. |
| ResetPassword(String, String) |
Redefine a palavra-passe de um utilizador para uma nova palavra-passe gerada automaticamente. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| UnlockUser(String) |
Limpa um bloqueio para que o utilizador membro possa ser validado. |
| UpdateUser(MembershipUser) |
Atualiza a informação sobre um utilizador na fonte de dados. |
| ValidateUser(String, String) |
Verifica se o nome de utilizador e a palavra-passe especificados existem na fonte de dados. |
evento
| Name | Description |
|---|---|
| ValidatingPassword |
Ocorre quando um utilizador é criado, uma palavra-passe é alterada ou uma palavra-passe é redefinida. |
