ActiveDirectoryMembershipUser 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.

Expõe e atualiza as informações de usuário associado armazenadas em um armazenamento de dados do Active Directory.

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser

[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser

[<System.Serializable>]
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser

Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser

Herança: Object

MembershipUser
ActiveDirectoryMembershipUser

Atributos: SerializableAttribute

Exemplos

O exemplo de código a seguir demonstra o uso de propriedades no ActiveDirectoryMembershipUser objeto em uma página da Web que podem retornar informações do usuário de vários armazenamentos de dados de associação. Como o ActiveDirectoryMembershipUser objeto subjacente ao MembershipUser objeto retornado pelo provedor de associação não implementa as LastActivityDate propriedades e LastLoginDate , o código primeiro verifica o tipo do objeto de usuário retornado do provedor de associação antes de exibir o conteúdo dessas propriedades.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    MembershipUser user =
        Membership.GetUser();

    userName.Text = user.UserName;
    emailAddress.Text = user.Email;

    // <Snippet2>
    if (user is ActiveDirectoryMembershipUser)
    {
      lastLoginDate.Text = "Not available";
      lastActivityDate.Text = "Not available";
    }
    else
    {
      lastLoginDate.Text = user.LastLoginDate.ToShortDateString();
      lastActivityDate.Text = user.LastActivityDate.ToShortDateString();
    }
    // </Snippet2>   
    
    // <Snippet3>
    System.Security.Principal.SecurityIdentifier sidValue =
      (System.Security.Principal.SecurityIdentifier)user.ProviderUserKey;

    sid.Text = sidValue.ToString();
    // </Snippet3>
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim user As MembershipUser = Membership.GetUser()
        
    userName.Text = user.UserName
    emailAddress.Text = user.Email
        
    ' <Snippet2>
    If TypeOf (user) Is ActiveDirectoryMembershipUser Then
      lastLoginDate.Text = "Not available"
      lastActivityDate.Text = "Not available"
    Else
      lastLoginDate.Text = user.LastLoginDate.ToString()
      lastActivityDate.Text = user.LastActivityDate.ToString()
    End If
    ' </Snippet2>
    
    ' <Snippet3>
    Dim sidValue As System.Security.Principal.SecurityIdentifier
    sidValue = CType(user.ProviderUserKey, System.Security.Principal.SecurityIdentifier)
    
    sid.Text = sidValue.ToString()
    ' </Snippet3>
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information page</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

Comentários

O ActiveDirectoryMembershipUser objeto é usado para representar um único usuário associado no armazenamento de dados de associação do Active Directory. Ele expõe informações sobre o usuário associado, como o endereço de email, e fornece funcionalidade para o usuário associado, como a capacidade de alterar ou redefinir sua senha.

Um ActiveDirectoryMembershipUser objeto é retornado pelo provedor de associação do aplicativo sempre que o aplicativo é configurado para usar um armazenamento de dados do Active Directory. Em um aplicativo que pode ser configurado para usar armazenamentos de dados diferentes ou em um aplicativo que usa vários armazenamentos de dados, você pode consultar a classe base , MembershipUser. Como o ActiveDirectoryMembershipUser objeto não implementa as LastActivityDate propriedades e LastLoginDate , você deve estar preparado para manipular o NotSupportedException que é gerado quando esses membros são acessados em um ActiveDirectoryMembershipUser objeto .

A ActiveDirectoryMembershipUser classe implementa otimizações internas usadas pela ActiveDirectoryMembershipProvider classe para minimizar o número de atualizações de atributo que ocorrem ao chamar o UpdateUser método . Ele também serializa a SecurityIdentifier representação (disponível na ProviderUserKey propriedade ) para que um ActiveDirectoryMembershipUser objeto possa ser serializado e desserializado sem gerar exceções.

Um ActiveDirectoryMembershipUser objeto é retornado pelos GetUser métodos e CreateUser ou como parte de um MembershipUserCollection retornado pelos GetAllUsersmétodos , FindUsersByNamee FindUsersByEmail .

Um ActiveDirectoryMembershipUser objeto é exigido pelo UpdateUser método quando você deseja atualizar as informações de um usuário associado existente.

ActiveDirectoryMembershipUser as propriedades são mapeadas para atributos do Active Directory. A tabela a seguir lista as ActiveDirectoryMembershipUser propriedades e seus mapeamentos de atributo padrão.

Propriedade	Atributo de diretório padrão	Pode ser mapeado?
ProviderUserKey	`securityIdentifier`	Não
UserName	`userPrincipalName`	Sim, mas deve ser userPrincipalName ou sAMAccountName
Comment	`comment`	Não
CreationDate	`whenCreated`	Não
Email	`mail`	Sim, mas deve ser um atributo de valor único do tipo Cadeia de Caracteres Unicode.
LastActivityDate	N/D	Não há suporte para ActiveDirectoryMembershipProvider.
LastLoginDate	N/D	Não há suporte para ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	Não
PasswordQuestion	nenhum, mas deve ser mapeado para um atributo se estiver usando a segurança de perguntas e respostas para redefinição ou recuperação de senha.	Sim, mas deve ser um atributo de valor único do tipo Cadeia de Caracteres Unicode.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADÃO)	Não
IsLockedOut	computado de e a duração do `lockoutTime` bloqueio do AD (AD no Windows 2000) `msDS-User-Account-Control-Computed` (AD no Windows Server 2003) `msDS-User-Account-Control-Computed` (ADÃO)	Não
LastLockoutDate	Se bloqueado devido a muitas tentativas de senha incorretas, o atributo de tempo de bloqueio será retornado. Se bloqueado devido a muitas tentativas de resposta de senha inválidas, o valor armazenado no atributo definido por `attributeMapFailedPasswordAnswerLockoutTime` será retornado. Se bloqueado devido a uma senha inválida e muitas tentativas de senha incorretas, o valor de data/hora mais recente será retornado. Se a conta não estiver bloqueada, retorne 1/1/1753 para compatibilidade do SQL.	Não

Construtores

ActiveDirectoryMembershipUser()	Inicializa uma nova instância de um objeto ActiveDirectoryMembershipUser para uma classe que herda a classe ActiveDirectoryMembershipUser.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Cria uma nova instância da classe ActiveDirectoryMembershipUser com os valores de propriedade especificados.

Propriedades

Comment	Obtém ou define informações específicas do aplicativo para o usuário associado.
CreationDate	Obtém a data e hora quando o usuário foi adicionado ao armazenamento de dados de associação. (Herdado de MembershipUser)
Email	Obtém ou define o endereço de email do usuário associado.
IsApproved	Obtém ou define um valor que indica se o usuário associado pode ser autenticado.
IsLockedOut	Obtém um valor que indica se o usuário associado está bloqueado e não pode ser validado. (Herdado de MembershipUser)
IsOnline	Especifica se o usuário está online no momento. (Herdado de MembershipUser)
LastActivityDate	Gera uma exceção NotSupportedException em todos os casos.
LastLockoutDate	Obtém a data e a hora mais recentes em que o usuário associado foi bloqueado. (Herdado de MembershipUser)
LastLoginDate	Gera uma exceção NotSupportedException em todos os casos.
LastPasswordChangedDate	Obtém a data e a hora da atualização mais recente da senha do usuário associado. (Herdado de MembershipUser)
PasswordQuestion	Obtém a pergunta da senha do usuário associado. (Herdado de MembershipUser)
ProviderName	Obtém o nome do provedor de associação que armazena e recupera informações de usuário para o usuário associado. (Herdado de MembershipUser)
ProviderUserKey	Obtém o identificador de usuário do armazenamento de dados do Active Directory para o usuário associado.
UserName	Obtém o nome de logon do usuário associado. (Herdado de MembershipUser)

Métodos

ChangePassword(String, String)	Atualiza a senha do usuário associado no armazenamento de dados de associação. (Herdado de MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Atualiza a pergunta e resposta de senha do usuário associado no armazenamento de dados de associação. (Herdado de MembershipUser)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPassword()	Obtém a senha do usuário associado do armazenamento de dados de associação. (Herdado de MembershipUser)
GetPassword(String)	Obtém a senha do usuário associado do armazenamento de dados de associação. (Herdado de MembershipUser)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ResetPassword()	Redefine a senha de um usuário com uma nova senha gerada automaticamente. (Herdado de MembershipUser)
ResetPassword(String)	Redefine a senha de um usuário com uma nova senha gerada automaticamente. (Herdado de MembershipUser)
ToString()	Retorna o nome de usuário para o usuário associado. (Herdado de MembershipUser)
UnlockUser()	Limpa o estado bloqueado do usuário para que o usuário associado possa ser validado. (Herdado de MembershipUser)

Aplica-se a

Confira também

Introdução à associação

Partilhar via