ActiveDirectoryMembershipUser Classe

Référence

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 sur les utilisateurs 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 retourner 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 , le code vérifie d’abord le type de l’objet utilisateur retourné par le fournisseur d’appartenances 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 membre, telles que 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’appartenances 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 , vous devez être prêt à gérer le NotSupportedException qui est levée lorsque ces membres sont accessibles sur un ActiveDirectoryMembershipUser objet .

La ActiveDirectoryMembershipUser classe implémente les 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 méthodes et CreateUser ou dans le GetUser cadre d’un MembershipUserCollection retourné par les GetAllUsersméthodes , FindUsersByNameet FindUsersByEmail .

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 d’annuaire par défaut	Peut être mappé ?
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é à 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	En cas de verrouillage en raison d’un trop grand nombre de tentatives de mot de passe incorrectes, l’attribut de durée de verrouillage est retourné. En cas de verrouillage 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. En cas de verrouillage en raison d’un mot de passe incorrect et d’un trop grand nombre de tentatives de mot de passe incorrectes, la valeur de 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

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

Propriétés

Comment	Obtient ou définit des informations propres à l’application pour l’utilisateur d’appartenance.
CreationDate	Obtient la date et l’heure d’ajout de l’utilisateur 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 indiquant si l'utilisateur d'appartenance peut être authentifié.
IsLockedOut	Obtient une valeur indiquant si l’utilisateur d’appartenance est verrouillé et impossible à valider. (Hérité de MembershipUser)
IsOnline	Détermine si l’utilisateur est actuellement en ligne. (Hérité de MembershipUser)
LastActivityDate	Lève une exception NotSupportedException dans tous les cas.
LastLockoutDate	Obtient la date et l’heure du dernier verrouillage de l’utilisateur d’appartenance. (Hérité de MembershipUser)
LastLoginDate	Lève une exception NotSupportedException 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 du 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 d'utilisateur du magasin de données Active Directory pour l'utilisateur d'appartenance.
UserName	Obtient le nom de connexion de l’utilisateur d’appartenance. (Hérité de MembershipUser)

Méthodes

ChangePassword(String, String)	Met à jour le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance. (Hérité de MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Met à jour la question et la réponse de mot de passe pour l’utilisateur d’appartenance (membership user) 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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetPassword()	Obtient le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance. (Hérité de MembershipUser)
GetPassword(String)	Obtient le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance. (Hérité de MembershipUser)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ResetPassword()	Réinitialise le mot de passe d’un utilisateur et affecte un nouveau mot de passe généré automatiquement. (Hérité de MembershipUser)
ResetPassword(String)	Réinitialise le mot de passe d’un utilisateur et affecte 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 pour que l’utilisateur d’appartenance puisse être validé. (Hérité de MembershipUser)

S’applique à

Voir aussi

Présentation de l’appartenance