ActiveDirectoryMembershipUser Classe

Définition

Espace de noms:: System.Web.Security

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Expose et met à jour les informations utilisateur d’appartenance stockées dans un magasin de données 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

Héritage: Object

MembershipUser
ActiveDirectoryMembershipUser

Attributs: SerializableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de propriétés sur l’objet ActiveDirectoryMembershipUser sur une page Web qui peuvent renvoyer des informations utilisateur à partir de plusieurs magasins de données d’appartenance. Étant donné que l’objet ActiveDirectoryMembershipUser qui sous-tend l’objet MembershipUser retourné par le fournisseur d’appartenances n’implémente pas les LastActivityDate propriétés et LastLoginDate les propriétés, le code vérifie d’abord le type de l’objet utilisateur retourné par le fournisseur d’appartenance avant d’afficher le contenu de ces propriétés.


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

Remarques

L’objet ActiveDirectoryMembershipUser est utilisé pour représenter un utilisateur d’appartenance unique dans le magasin de données d’appartenance Active Directory. Il expose des informations sur l’utilisateur d’appartenance, comme l’adresse e-mail, et fournit des fonctionnalités pour l’utilisateur d’appartenance, telles que la possibilité de modifier ou de réinitialiser son mot de passe.

Un ActiveDirectoryMembershipUser objet est retourné par le fournisseur d’appartenance de l’application chaque fois que l’application est configurée pour utiliser un magasin de données Active Directory. Dans une application qui peut être configurée pour utiliser différents magasins de données ou dans une application qui utilise plusieurs magasins de données, vous pouvez faire référence à la classe de base. MembershipUser Étant donné que l’objet ActiveDirectoryMembershipUser n’implémente pas les LastActivityDate propriétés et LastLoginDate que vous devez être prêt à gérer celui NotSupportedException qui est levée lorsque ces membres sont accessibles sur un ActiveDirectoryMembershipUser objet.

La ActiveDirectoryMembershipUser classe implémente des optimisations internes utilisées par la ActiveDirectoryMembershipProvider classe pour réduire le nombre de mises à jour d’attributs qui se produisent lors de l’appel de la UpdateUser méthode. Il sérialise également la SecurityIdentifier représentation (disponible dans la ProviderUserKey propriété) afin qu’un ActiveDirectoryMembershipUser objet puisse être sérialisé et désérialisé sans lever d’exceptions.

Un ActiveDirectoryMembershipUser objet est retourné par les GetUser méthodes et CreateUser les méthodes ou dans le cadre d’un MembershipUserCollection retour par les GetAllUsersméthodes, FindUsersByNameet FindUsersByEmail les méthodes.

Un ActiveDirectoryMembershipUser objet est requis par la UpdateUser méthode lorsque vous souhaitez mettre à jour les informations d’un utilisateur d’appartenance existant.

ActiveDirectoryMembershipUser les propriétés sont mappées aux attributs Active Directory. Le tableau suivant répertorie les ActiveDirectoryMembershipUser propriétés et leurs mappages d’attributs par défaut.

Propriété	Attribut de répertoire par défaut	Peut-on mapper ?
ProviderUserKey	`securityIdentifier`	Non
UserName	`userPrincipalName`	Oui, mais doit être userPrincipalName ou sAMAccountName
Comment	`comment`	Non
CreationDate	`whenCreated`	Non
Email	`mail`	Oui, mais doit être un attribut à valeur unique de type Chaîne Unicode.
LastActivityDate	n/a	Non pris en charge par ActiveDirectoryMembershipProvider.
LastLoginDate	n/a	Non pris en charge par ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	Non
PasswordQuestion	aucun, mais doit être mappé à un attribut si vous utilisez la sécurité des questions-réponses pour la réinitialisation ou la récupération du mot de passe.	Oui, mais doit être un attribut à valeur unique de type Chaîne Unicode.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	Non
IsLockedOut	calculée à partir de et la durée de `lockoutTime` verrouillage AD (AD sur Windows 2000) `msDS-User-Account-Control-Computed` (AD sur Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	Non
LastLockoutDate	S’il est verrouillé en raison d’un trop grand nombre de tentatives de mot de passe incorrectes, l’attribut de temps de verrouillage est retourné. Si elle est verrouillée en raison d’un trop grand nombre de tentatives de réponse de mot de passe incorrectes, la valeur stockée dans l’attribut défini par `attributeMapFailedPasswordAnswerLockoutTime` est retournée. S’il est verrouillé en raison d’un mot de passe incorrect et d’un trop grand nombre de tentatives de mot de passe incorrectes, la valeur date/heure la plus récente est retournée. Si le compte n’est pas verrouillé, retournez le 1/1/1753 pour la compatibilité SQL.	Non

Constructeurs

Nom	Description
ActiveDirectoryMembershipUser()	Initialise une nouvelle instance d’un ActiveDirectoryMembershipUser objet pour une classe qui hérite de la ActiveDirectoryMembershipUser classe.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Crée une instance de la ActiveDirectoryMembershipUser classe avec les valeurs de propriété spécifiées.

Propriétés

Nom	Description
Comment	Obtient ou définit des informations spécifiques à l’application pour l’utilisateur d’appartenance.
CreationDate	Obtient la date et l’heure à laquelle l’utilisateur a été ajouté au magasin de données d’appartenance. (Hérité de MembershipUser)
Email	Obtient ou définit l’adresse e-mail de l’utilisateur d’appartenance.
IsApproved	Obtient ou définit une valeur qui indique si l’utilisateur d’appartenance peut être authentifié.
IsLockedOut	Obtient une valeur indiquant si l’utilisateur d’appartenance est verrouillé et ne peut pas être validé. (Hérité de MembershipUser)
IsOnline	Obtient si l’utilisateur est actuellement en ligne. (Hérité de MembershipUser)
LastActivityDate	Lève une NotSupportedException exception dans tous les cas.
LastLockoutDate	Obtient la date et l’heure les plus récentes pendant laquelle l’utilisateur d’appartenance a été verrouillé. (Hérité de MembershipUser)
LastLoginDate	Lève une NotSupportedException exception dans tous les cas.
LastPasswordChangedDate	Obtient la date et l’heure de la dernière mise à jour du mot de passe de l’utilisateur d’appartenance. (Hérité de MembershipUser)
PasswordQuestion	Obtient la question de mot de passe pour l’utilisateur d’appartenance. (Hérité de MembershipUser)
ProviderName	Obtient le nom du fournisseur d’appartenances qui stocke et récupère les informations utilisateur pour l’utilisateur d’appartenance. (Hérité de MembershipUser)
ProviderUserKey	Obtient l’identificateur de l’utilisateur à partir du magasin de données Active Directory pour l’utilisateur d’appartenance.
UserName	Obtient le nom d’ouverture de session de l’utilisateur d’appartenance. (Hérité de MembershipUser)

Méthodes

Nom	Description
ChangePassword(String, String)	Met à jour le mot de passe de l’utilisateur d’appartenance dans le magasin de données d’appartenance. (Hérité de MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Met à jour la question de mot de passe et la réponse de l’utilisateur d’appartenance dans le magasin de données d’appartenance. (Hérité de MembershipUser)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetPassword()	Obtient le mot de passe de l’utilisateur d’appartenance à partir du magasin de données d’appartenance. (Hérité de MembershipUser)
GetPassword(String)	Obtient le mot de passe de l’utilisateur d’appartenance à partir du magasin de données d’appartenance. (Hérité de MembershipUser)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ResetPassword()	Réinitialise le mot de passe d’un utilisateur à un nouveau mot de passe généré automatiquement. (Hérité de MembershipUser)
ResetPassword(String)	Réinitialise le mot de passe d’un utilisateur à un nouveau mot de passe généré automatiquement. (Hérité de MembershipUser)
ToString()	Retourne le nom d’utilisateur de l’utilisateur d’appartenance. (Hérité de MembershipUser)
UnlockUser()	Efface l’état verrouillé de l’utilisateur afin que l’utilisateur d’appartenance puisse être validé. (Hérité de MembershipUser)

S’applique à

Voir aussi

Présentation de l’appartenance

Commentaires

Est-ce que cette page vous a été utile?