Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

ActiveDirectoryMembershipUser (Clase)

.NET Framework 4

Expone y actualiza información de usuario de pertenencia almacenada en un almacén de datos de Active Directory.

System.Object
  System.Web.Security.MembershipUser
    System.Web.Security.ActiveDirectoryMembershipUser

Espacio de nombres:  System.Web.Security
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
[SerializableAttribute]
public class ActiveDirectoryMembershipUser : MembershipUser

El tipo ActiveDirectoryMembershipUser expone los siguientes miembros.

  Nombre Descripción
Método protegido ActiveDirectoryMembershipUser() Inicializa una nueva instancia de un objeto ActiveDirectoryMembershipUser para una clase que hereda la clase ActiveDirectoryMembershipUser.
Método público 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.
Arriba
  Nombre Descripción
Propiedad pública Comment Obtiene o establece la información específica de la aplicación correspondiente al usuario de pertenencia. (Invalida a MembershipUser.Comment).
Propiedad pública CreationDate Obtiene la fecha y hora en la que se agregó al usuario al almacén de datos de la pertenencia. (Se hereda de MembershipUser).
Propiedad pública Email Obtiene o establece la dirección de correo electrónico del usuario de pertenencia. (Invalida a MembershipUser.Email).
Propiedad pública IsApproved Obtiene o establece un valor que indica si se puede autenticar el usuario de pertenencia. (Invalida a MembershipUser.IsApproved).
Propiedad pública IsLockedOut Obtiene un valor que indica si se bloquea el usuario de pertenencia y no se puede validar. (Se hereda de MembershipUser).
Propiedad pública IsOnline Obtiene si el usuario está actualmente en línea. (Se hereda de MembershipUser).
Propiedad pública LastActivityDate Produce una excepción NotSupportedException en todos los casos. (Invalida a MembershipUser.LastActivityDate).
Propiedad pública LastLockoutDate Obtiene la más fecha y hora más reciente en la que se bloqueó al usuario de pertenencia (Se hereda de MembershipUser).
Propiedad pública LastLoginDate Produce una excepción NotSupportedException en todos los casos. (Invalida a MembershipUser.LastLoginDate).
Propiedad pública LastPasswordChangedDate Obtiene la fecha y hora en la que la contraseña del usuario de pertenencia fue actualizada por última vez. (Se hereda de MembershipUser).
Propiedad pública PasswordQuestion Obtiene la pregunta de la contraseña para el usuario de pertenencia. (Se hereda de MembershipUser).
Propiedad pública ProviderName Obtiene el nombre del proveedor de pertenencia que almacena y recupera información de usuario correspondiente al usuario de pertenencia. (Se hereda de MembershipUser).
Propiedad pública ProviderUserKey Recibe el identificador de usuario del almacén de datos de Active Directory para el usuario de pertenencia. (Invalida a MembershipUser.ProviderUserKey).
Propiedad pública UserName Obtiene el nombre de inicio de sesión del usuario de pertenencia. (Se hereda de MembershipUser).
Arriba
  Nombre Descripción
Método público ChangePassword Actualiza la contraseña del almacén de datos de pertenencia para el usuario de pertenencia. (Se hereda de MembershipUser).
Método público ChangePasswordQuestionAndAnswer Actualiza la pregunta y la repuesta de contraseña correspondiente al usuario de pertenencia en el almacén de datos de la pertenencia. (Se hereda de MembershipUser).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetPassword() Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia. (Se hereda de MembershipUser).
Método público GetPassword(String) Obtiene la contraseña del almacén de datos de pertenencia para el usuario de pertenencia. (Se hereda de MembershipUser).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público ResetPassword() Restablece la contraseña de un usuario a una nueva generada automáticamente. (Se hereda de MembershipUser).
Método público ResetPassword(String) Restablece la contraseña de un usuario a una nueva generada automáticamente. (Se hereda de MembershipUser).
Método público ToString Devuelve el nombre de usuario correspondiente al usuario de pertenencia. (Se hereda de MembershipUser).
Método público UnlockUser Borra el estado de bloqueo del usuario para que se pueda validar el usuario de pertenencia. (Se hereda de MembershipUser).
Arriba

El objeto ActiveDirectoryMembershipUser se utiliza para representar un usuario de pertenencia único en el almacén de datos de pertenencia de 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 la contraseña.

El proveedor de pertenencia de la aplicación devuelve un objeto ActiveDirectoryMembershipUser cada vez que se configura la aplicación para utilizar un almacén de datos de Active Directory. En una aplicación que se puede configurar para utilizar almacenes de datos distintos o en una aplicación que utiliza varios almacenes de datos, puede hacer referencia a la clase base, MembershipUser. Dado que el objeto ActiveDirectoryMembershipUser no implementa las propiedades LastActivityDate y LastLoginDate, debe prepararse para controlar la excepción NotSupportedException que se produce cuando se obtiene acceso a estos miembros en un objeto ActiveDirectoryMembershipUser.

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

Los métodos GetUser y CreateUser devuelven un objeto ActiveDirectoryMembershipUser o como parte del objeto MembershipUserCollection devuelto por los métodos GetAllUsers, FindUsersByName y FindUsersByEmail.

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

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

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 de un solo valor de tipo cadena Unicode.

LastActivityDate

no disponible

No es compatible con ActiveDirectoryMembershipProvider.

LastLoginDate

no disponible

No es compatible con ActiveDirectoryMembershipProvider.

LastPasswordChangedDate

pwdLastSet

No

PasswordQuestion

ninguno, pero se debe asignar a un atributo si se utiliza la seguridad de pregunta y respuesta para el restablecimiento o recuperación de contraseña.

Sí, pero debe ser un atributo de un solo valor de tipo cadena Unicode.

IsApproved

User-Account-Control (AD)

mDS-UserAccountDisabled (ADAM)

No

IsLockedOut

Se calcula de 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 con contraseña incorrecta, se devuelve el atributo de hora de bloqueo.

Si se bloquea debido a demasiados intentos de respuesta con contraseña incorrecta, se devuelve el valor almacenado en el atributo definido por attributeMapFailedPasswordAnswerLockoutTime.

Si se bloquea debido a una contraseña incorrecta y a demasiados intentos con contraseñas incorrectas, se devuelve el valor de fecha y hora más reciente.

Si no se bloquea la cuenta, devuelve 1/1/1753 para la compatibilidad con SQL.

No

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

C#
VB
Copiar 


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

    if (user is ActiveDirectoryMembershipUser)
    {
      lastLoginDate.Text = "Not available";
      lastActivityDate.Text = "Not available";
    }
    else
    {
      lastLoginDate.Text = user.LastLoginDate.ToShortDateString();
      lastActivityDate.Text = user.LastActivityDate.ToShortDateString();
    }

    System.Security.Principal.SecurityIdentifier sidValue =
      (System.Security.Principal.SecurityIdentifier)user.ProviderUserKey;

    sid.Text = sidValue.ToString();
  }
</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>
            E-mail 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>

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes