ActiveDirectoryMembershipUser Clase

Definición

Espacio de nombres:: System.Web.Security

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Expone y actualiza la información del usuario de pertenencia almacenada en un almacén de datos de 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

Herencia: Object

MembershipUser
ActiveDirectoryMembershipUser

Atributos: SerializableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de propiedades en el ActiveDirectoryMembershipUser objeto de una página web que puede devolver información de usuario de varios almacenes de datos de pertenencia. Dado que el ActiveDirectoryMembershipUser objeto subyacente al MembershipUser objeto devuelto por el proveedor de pertenencia no implementa las LastActivityDate propiedades y LastLoginDate , el código comprueba primero el tipo del objeto de usuario devuelto por el proveedor de pertenencia antes de mostrar el contenido de esas propiedades.


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

Comentarios

El ActiveDirectoryMembershipUser objeto se usa para representar un único usuario de pertenencia en el almacén de datos de pertenencia a Active Directory. Expone información sobre el usuario de pertenencia, como la dirección de correo electrónico, y proporciona funcionalidad para el usuario de pertenencia, como la capacidad de cambiar o restablecer su contraseña.

El proveedor de pertenencia de la aplicación devuelve un ActiveDirectoryMembershipUser objeto cada vez que la aplicación está configurada para usar un almacén de datos de Active Directory. En una aplicación que se puede configurar para usar almacenes de datos diferentes o en una aplicación que usa varios almacenes de datos, puede hacer referencia a la clase base, MembershipUser. Dado que el ActiveDirectoryMembershipUser objeto no implementa las LastActivityDate propiedades y LastLoginDate , debe estar preparado para controlar el NotSupportedException que se produce cuando se accede a estos miembros en un ActiveDirectoryMembershipUser objeto .

La ActiveDirectoryMembershipUser clase implementa optimizaciones internas usadas por la ActiveDirectoryMembershipProvider clase para minimizar el número de actualizaciones de atributos que se producen al llamar al UpdateUser método . También serializa la SecurityIdentifier representación (disponible en la ProviderUserKey propiedad) para que un ActiveDirectoryMembershipUser objeto se pueda serializar y deserializar sin producir excepciones.

Los métodos y devuelven un ActiveDirectoryMembershipUser objeto GetUser o como parte de un MembershipUserCollection devuelto por los GetAllUsersmétodos , FindUsersByNamey FindUsersByEmail .CreateUser

El método requiere UpdateUser un ActiveDirectoryMembershipUser objeto cuando desea actualizar la información de un usuario de pertenencia existente.

ActiveDirectoryMembershipUser las propiedades se asignan a atributos de Active Directory. En la tabla siguiente se enumeran las ActiveDirectoryMembershipUser propiedades y sus asignaciones de atributos predeterminadas.

Propiedad	Atributo de directorio predeterminado	¿Se puede asignar?
ProviderUserKey	`securityIdentifier`	No
UserName	`userPrincipalName`	Sí, pero debe ser userPrincipalName o sAMAccountName.
Comment	`comment`	No
CreationDate	`whenCreated`	No
Email	`mail`	Sí, pero debe ser un atributo con un solo valor de tipo Cadena Unicode.
LastActivityDate	n/a	No es compatible con ActiveDirectoryMembershipProvider.
LastLoginDate	n/a	No es compatible con ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	No
PasswordQuestion	ninguno, pero debe asignarse a un atributo si se usa la seguridad de preguntas y respuestas para el restablecimiento o recuperación de contraseñas.	Sí, pero debe ser un atributo con un solo valor de tipo Cadena Unicode.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	No
IsLockedOut	calculado desde `lockoutTime` y la duración del bloqueo de AD (AD en Windows 2000) `msDS-User-Account-Control-Computed` (AD en Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	No
LastLockoutDate	Si se bloquea debido a demasiados intentos de contraseña incorrectos, se devuelve el atributo de tiempo de bloqueo. Si se bloquea debido a demasiados intentos de respuesta de contraseña incorrectos, se devuelve el valor almacenado en el atributo definido por `attributeMapFailedPasswordAnswerLockoutTime` . Si se bloquea debido a una contraseña incorrecta y a demasiados intentos de contraseña incorrectos, se devuelve el valor de fecha y hora más reciente. Si la cuenta no está bloqueada, devuelva 1/1/1753 por compatibilidad con SQL.	No

Constructores

Nombre	Description
ActiveDirectoryMembershipUser()	Inicializa una nueva instancia de un ActiveDirectoryMembershipUser objeto para una clase que hereda la ActiveDirectoryMembershipUser clase .
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Crea una nueva instancia de la ActiveDirectoryMembershipUser clase con los valores de propiedad especificados.

Propiedades

Nombre	Description
Comment	Obtiene o establece información específica de la aplicación para el usuario de pertenencia.
CreationDate	Obtiene la fecha y hora en que el usuario se agregó al almacén de datos de pertenencia. (Heredado de MembershipUser)
Email	Obtiene o establece la dirección de correo electrónico del usuario de pertenencia.
IsApproved	Obtiene o establece un valor que indica si el usuario de pertenencia se puede autenticar.
IsLockedOut	Obtiene un valor que indica si el usuario de pertenencia está bloqueado y no se puede validar. (Heredado de MembershipUser)
IsOnline	Obtiene si el usuario está actualmente en línea. (Heredado de MembershipUser)
LastActivityDate	Produce una NotSupportedException excepción en todos los casos.
LastLockoutDate	Obtiene la fecha y hora más recientes en que se bloqueó el usuario de pertenencia. (Heredado de MembershipUser)
LastLoginDate	Produce una NotSupportedException excepción en todos los casos.
LastPasswordChangedDate	Obtiene la fecha y hora en que se actualizó por última vez la contraseña del usuario de pertenencia. (Heredado de MembershipUser)
PasswordQuestion	Obtiene la pregunta de contraseña del usuario de pertenencia. (Heredado de MembershipUser)
ProviderName	Obtiene el nombre del proveedor de pertenencia que almacena y recupera información de usuario para el usuario de pertenencia. (Heredado de MembershipUser)
ProviderUserKey	Obtiene el identificador de usuario del almacén de datos de Active Directory para el usuario de pertenencia.
UserName	Obtiene el nombre de inicio de sesión del usuario de pertenencia. (Heredado de MembershipUser)

Métodos

Nombre	Description
ChangePassword(String, String)	Actualiza la contraseña del usuario de pertenencia en el almacén de datos de pertenencia. (Heredado de MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Actualiza la pregunta y respuesta de contraseña para el usuario de pertenencia en el almacén de datos de pertenencia. (Heredado de MembershipUser)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetPassword()	Obtiene la contraseña del usuario de pertenencia del almacén de datos de pertenencia. (Heredado de MembershipUser)
GetPassword(String)	Obtiene la contraseña del usuario de pertenencia del almacén de datos de pertenencia. (Heredado de MembershipUser)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ResetPassword()	Restablece la contraseña de un usuario a una nueva contraseña generada automáticamente. (Heredado de MembershipUser)
ResetPassword(String)	Restablece la contraseña de un usuario a una nueva contraseña generada automáticamente. (Heredado de MembershipUser)
ToString()	Devuelve el nombre de usuario del usuario de pertenencia. (Heredado de MembershipUser)
UnlockUser()	Borra el estado bloqueado del usuario para que se pueda validar el usuario de pertenencia. (Heredado de MembershipUser)

Se aplica a

Consulte también

Introducción a la pertenencia

Comentarios

¿Le resultó útil esta página?

Compartir vía

ActiveDirectoryMembershipUser Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

Comentarios