ActiveDirectoryMembershipUser Clase

Referencia

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 información de 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 que subyace 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 distintos almacenes de datos 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 objeto 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 GetUser un ActiveDirectoryMembershipUser objeto 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 de un solo valor de tipo String Unicode.
LastActivityDate	N/D	No admitida por ActiveDirectoryMembershipProvider.
LastLoginDate	N/D	No admitida por ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	No
PasswordQuestion	none, 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 de un solo valor de tipo String 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 incorrectas, 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 incorrectas, 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

ActiveDirectoryMembershipUser()	Inicializa una nueva instancia de un objeto ActiveDirectoryMembershipUser para una clase que hereda la clase ActiveDirectoryMembershipUser.
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.

Propiedades

Comment	Obtiene o establece la información específica de la aplicación para el usuario de pertenencia.
CreationDate	Obtiene la fecha y la hora en que se agregó el usuario al almacén de datos de la suscripción. (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 se puede autenticar el usuario de pertenencia.
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á en línea actualmente. (Heredado de MembershipUser)
LastActivityDate	Se produce una excepción NotSupportedException en todos los casos.
LastLockoutDate	Obtiene la última fecha y hora en que se bloqueó el usuario de pertenencia. (Heredado de MembershipUser)
LastLoginDate	Se produce una excepción NotSupportedException en todos los casos.
LastPasswordChangedDate	Obtiene la fecha y la 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	Recibe 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

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 la respuesta de la 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 que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la 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 Object actual. (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 para el usuario de pertenencia. (Heredado de MembershipUser)
UnlockUser()	Borra el estado de bloqueo 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

ActiveDirectoryMembershipUser Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

Comentarios

Comentarios

Recursos adicionales