ActiveDirectoryMembershipUser ActiveDirectoryMembershipUser ActiveDirectoryMembershipUser ActiveDirectoryMembershipUser Class

Definición

Expone y actualiza información de usuario de pertenencia almacenada en un almacén de datos de Active Directory.Exposes and updates membership user information stored in an Active Directory data store.

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser
[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser
Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser
Herencia
ActiveDirectoryMembershipUserActiveDirectoryMembershipUserActiveDirectoryMembershipUserActiveDirectoryMembershipUser
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar las propiedades en la ActiveDirectoryMembershipUser objeto en una página Web que puede devolver información de usuario de varios almacenes de datos de pertenencia.The following code example demonstrates using properties on the ActiveDirectoryMembershipUser object on a Web page that may return user information from multiple membership data stores. Porque el ActiveDirectoryMembershipUser objeto subyacente el MembershipUser objeto devuelto por el proveedor de pertenencia no implementa la LastActivityDate y LastLoginDate propiedades, el código comprueba primero el tipo del objeto de usuario devuelto de la pertenencia proveedor antes de mostrar el contenido de esas propiedades.Because the ActiveDirectoryMembershipUser object that underlies the MembershipUser object returned by the membership provider does not implement the LastActivityDate and LastLoginDate properties, the code first checks the type of the user object returned from the membership provider before displaying the contents of those properties.


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

La ActiveDirectoryMembershipUser objeto se usa para representar un usuario de pertenencia único en el almacén de datos de pertenencia de Active Directory.The ActiveDirectoryMembershipUser object is used to represent a single membership user in the Active Directory membership data store. Expone información sobre el usuario de pertenencia, como la dirección de correo electrónico y proporciona la funcionalidad para el usuario de pertenencia, como la capacidad de cambiar o restablecer su contraseña.It exposes information about the membership user such as the email address, and provides functionality for the membership user such as the ability to change or reset his or her password.

Un ActiveDirectoryMembershipUser objeto devuelto por el proveedor de pertenencia de la aplicación cada vez que la aplicación está configurada para usar un almacén de datos de Active Directory.An ActiveDirectoryMembershipUser object is returned by the application's membership provider whenever the application is configured to use an Active Directory data store. En una aplicación que se puede configurar para usar datos distintos almacenes, o en una aplicación que usa varios almacenes de datos, puede hacer referencia a la clase base, MembershipUser.In an application that can be configured to use different data stores, or in an application that uses multiple data stores, you can refer to the base class, MembershipUser. Dado que el ActiveDirectoryMembershipUser objeto no implementa la LastActivityDate y LastLoginDate propiedades, debe estar preparado para controlar la NotSupportedException que se produce cuando se tiene acceso a estos miembros en un ActiveDirectoryMembershipUser objeto.Because the ActiveDirectoryMembershipUser object does not implement the LastActivityDate and LastLoginDate properties, you must be prepared to handle the NotSupportedException that is thrown when these members are accessed on an ActiveDirectoryMembershipUser object.

El ActiveDirectoryMembershipUser clase implementa optimizaciones internas utilizadas por el ActiveDirectoryMembershipProvider clase para minimizar el número de actualizaciones de atributos que se producen cuando se llama a la UpdateUser método.The ActiveDirectoryMembershipUser class implements internal optimizations used by the ActiveDirectoryMembershipProvider class to minimize the number of attribute updates that occur when calling the UpdateUser method. También serializa el SecurityIdentifier representación (disponible en el ProviderUserKey propiedad) para que un ActiveDirectoryMembershipUser objeto se puede serializar y deserializar sin iniciar excepciones.It also serializes the SecurityIdentifier representation (available in the ProviderUserKey property) so that an ActiveDirectoryMembershipUser object can be serialized and deserialized without throwing exceptions.

Un ActiveDirectoryMembershipUser objeto devuelto por la GetUser y CreateUser métodos o como parte de un MembershipUserCollection devuelto por la GetAllUsers, FindUsersByName, y FindUsersByEmail métodos.A ActiveDirectoryMembershipUser object is returned by the GetUser and CreateUser methods or as part of a MembershipUserCollection returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods.

Un ActiveDirectoryMembershipUser objeto requiere el UpdateUser método cuando desee actualizar la información de un usuario de pertenencia existente.An ActiveDirectoryMembershipUser object is required by the UpdateUser method when you want to update the information for an existing membership user.

ActiveDirectoryMembershipUser las propiedades se asignan a atributos de Active Directory.ActiveDirectoryMembershipUser properties are mapped to Active Directory attributes. La siguiente tabla se enumeran los ActiveDirectoryMembershipUser asignaciones de atributos de las propiedades y su valor predeterminado.The following table lists the ActiveDirectoryMembershipUser properties and their default attribute mappings.

Propiedad.Property Atributo de directorio predeterminadoDefault directory attribute ¿Se pueden asignar?Can be mapped?
ProviderUserKey securityIdentifier NoNo
UserName userPrincipalName Sí, pero debe ser userPrincipalName o sAMAccountNameYes, but must be either userPrincipalName or sAMAccountName
Comment comment NoNo
CreationDate whenCreated NoNo
Email mail Sí, pero debe ser un atributo de un solo valor de tipo Unicode String.Yes, but must be a single-valued attribute of type Unicode String.
LastActivityDate N/Dn/a No se admite por ActiveDirectoryMembershipProvider.Not supported by ActiveDirectoryMembershipProvider.
LastLoginDate N/Dn/a No se admite por ActiveDirectoryMembershipProvider.Not supported by ActiveDirectoryMembershipProvider.
LastPasswordChangedDate pwdLastSet NoNo
PasswordQuestion Ninguno, pero debe estar asignado a un atributo, si usa la seguridad de preguntas y respuestas para restablecer la contraseña o la recuperación.none, but must be mapped to an attribute if using question-and-answer security for password reset or retrieval. Sí, pero debe ser un atributo de un solo valor de tipo Unicode String.Yes, but must be a single-valued attribute of type Unicode String.
IsApproved User-Account-Control (AD)User-Account-Control (AD)

mDS-UserAccountDisabled (ADAM)mDS-UserAccountDisabled (ADAM)
NoNo
IsLockedOut calcular a partir de lockoutTime y la duración del bloqueo de AD (AD en Windows 2000)computed from lockoutTime and the AD lockout duration (AD on Windows 2000)

msDS-User-Account-Control-Computed (AD en Windows Server 2003)msDS-User-Account-Control-Computed (AD on Windows Server 2003)

msDS-User-Account-Control-Computed (ADAM)msDS-User-Account-Control-Computed (ADAM)
NoNo
LastLockoutDate Si se bloquea debido a demasiados intentos con contraseñas incorrectas, se devuelve el atributo de tiempo de bloqueo.If locked out due to too many bad password attempts, the lockout time attribute is returned.

Si se bloquea debido a la respuesta de contraseña incorrecta demasiadas intentos, el valor almacenado en el atributo definido por attributeMapFailedPasswordAnswerLockoutTime se devuelve.If locked out due to too many bad password answer attempts, the value stored in the attribute defined by attributeMapFailedPasswordAnswerLockoutTime is returned.

Si se bloquea debido a una contraseña incorrecta y contraseña incorrecta demasiadas intentos, se devuelve el valor de fecha y hora más reciente.If locked out due to both a bad password and too many bad password attempts, the most recent date/time value is returned.

Si la cuenta no está bloqueada, devuelve 1/1/1753 por compatibilidad con SQL.If the account is not locked out, return 1/1/1753 for SQL compatibility.
NoNo

Constructores

ActiveDirectoryMembershipUser() ActiveDirectoryMembershipUser() ActiveDirectoryMembershipUser() ActiveDirectoryMembershipUser()

Inicializa una nueva instancia de un objeto ActiveDirectoryMembershipUser para una clase que hereda la clase ActiveDirectoryMembershipUser.Initializes a new instance of an ActiveDirectoryMembershipUser object for a class that inherits the ActiveDirectoryMembershipUser class.

ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime) ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime) ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime) ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Crea una nueva instancia de la clase ActiveDirectoryMembershipUser con los valores de propiedades especificados.Creates a new instance of the ActiveDirectoryMembershipUser class with the specified property values.

Propiedades

Comment Comment Comment Comment

Obtiene o establece la información específica de la aplicación para el usuario de pertenencia.Gets or sets application-specific information for the membership user.

CreationDate CreationDate CreationDate CreationDate

Obtiene la fecha y la hora en que se agregó el usuario al almacén de datos de la suscripción.Gets the date and time when the user was added to the membership data store.

(Inherited from MembershipUser)
Email Email Email Email

Obtiene o establece la dirección de correo electrónico del usuario de pertenencia.Gets or sets the email address of the membership user.

IsApproved IsApproved IsApproved IsApproved

Obtiene o establece un valor que indica si se puede autenticar el usuario de pertenencia.Gets or sets a value that indicates whether the membership user can be authenticated.

IsLockedOut IsLockedOut IsLockedOut IsLockedOut

Obtiene un valor que indica si se bloquea el usuario de pertenencia y no se puede validar.Gets a value indicating whether the membership user is locked out and unable to be validated.

(Inherited from MembershipUser)
IsOnline IsOnline IsOnline IsOnline

Obtiene si el usuario está actualmente en línea.Gets whether the user is currently online.

(Inherited from MembershipUser)
LastActivityDate LastActivityDate LastActivityDate LastActivityDate

Produce una excepción NotSupportedException en todos los casos.Throws a NotSupportedException exception in all cases

LastLockoutDate LastLockoutDate LastLockoutDate LastLockoutDate

Obtiene la más fecha y hora más reciente en la que se bloqueó al usuario de pertenenciaGets the most recent date and time that the membership user was locked out.

(Inherited from MembershipUser)
LastLoginDate LastLoginDate LastLoginDate LastLoginDate

Se produce una excepción NotSupportedException en todos los casos.Throws a NotSupportedException exception in all cases.

LastPasswordChangedDate LastPasswordChangedDate LastPasswordChangedDate LastPasswordChangedDate

Obtiene la fecha y hora en la que la contraseña del usuario de pertenencia fue actualizada por última vez.Gets the date and time when the membership user's password was last updated.

(Inherited from MembershipUser)
PasswordQuestion PasswordQuestion PasswordQuestion PasswordQuestion

Obtiene la pregunta de la contraseña para el usuario de pertenencia.Gets the password question for the membership user.

(Inherited from MembershipUser)
ProviderName ProviderName ProviderName ProviderName

Obtiene el nombre del proveedor de pertenencia que almacena y recupera información de usuario correspondiente al usuario de pertenencia.Gets the name of the membership provider that stores and retrieves user information for the membership user.

(Inherited from MembershipUser)
ProviderUserKey ProviderUserKey ProviderUserKey ProviderUserKey

Recibe el identificador de usuario del almacén de datos de Active Directory para el usuario de pertenencia.Gets the user identifier from the Active Directory data store for the membership user.

UserName UserName UserName UserName

Obtiene el nombre de inicio de sesión del usuario de pertenencia.Gets the logon name of the membership user.

(Inherited from MembershipUser)

Métodos

ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String)

Actualiza la contraseña del usuario de pertenencia en el almacén de datos de pertenencia.Updates the password for the membership user in the membership data store.

(Inherited from MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String) ChangePasswordQuestionAndAnswer(String, String, String)

Actualiza la pregunta y la respuesta de la contraseña para el usuario de pertenencia en el almacén de datos de pertenencia.Updates the password question and answer for the membership user in the membership data store.

(Inherited from MembershipUser)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPassword() GetPassword() GetPassword() GetPassword()

Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia.Gets the password for the membership user from the membership data store.

(Inherited from MembershipUser)
GetPassword(String) GetPassword(String) GetPassword(String) GetPassword(String)

Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia.Gets the password for the membership user from the membership data store.

(Inherited from MembershipUser)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ResetPassword() ResetPassword() ResetPassword() ResetPassword()

Restablece la contraseña de un usuario a una nueva generada automáticamente.Resets a user's password to a new, automatically generated password.

(Inherited from MembershipUser)
ResetPassword(String) ResetPassword(String) ResetPassword(String) ResetPassword(String)

Restablece la contraseña de un usuario a una nueva generada automáticamente.Resets a user's password to a new, automatically generated password.

(Inherited from MembershipUser)
ToString() ToString() ToString() ToString()

Devuelve el nombre de usuario correspondiente al usuario de pertenencia.Returns the user name for the membership user.

(Inherited from MembershipUser)
UnlockUser() UnlockUser() UnlockUser() UnlockUser()

Borra el estado de bloqueo del usuario para que se pueda validar el usuario de pertenencia.Clears the locked-out state of the user so that the membership user can be validated.

(Inherited from MembershipUser)

Se aplica a

Consulte también: