Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ActiveDirectoryMembershipUser classe

 

Date de publication : novembre 2016

Expose et met à jour les informations d’appartenance utilisateur stockées dans un magasin de données Active Directory.

Espace de noms:   System.Web.Security
Assembly:  System.Web (dans System.Web.dll)

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

[SerializableAttribute]
public class ActiveDirectoryMembershipUser : MembershipUser

NomDescription
System_CAPS_protmethodActiveDirectoryMembershipUser()

Initialise une nouvelle instance d’un ActiveDirectoryMembershipUser objet pour une classe qui hérite de la ActiveDirectoryMembershipUser classe.

System_CAPS_pubmethodActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Crée une nouvelle instance de la ActiveDirectoryMembershipUser classe avec les valeurs de propriété spécifiée.

NomDescription
System_CAPS_pubpropertyComment

Obtient ou définit des informations propres à l’application pour l’utilisateur d’appartenance.(Remplace MembershipUser.Comment.)

System_CAPS_pubpropertyCreationDate

Obtient la date et l’heure d’ajout de l’utilisateur au magasin de données d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubpropertyEmail

Obtient ou définit l’adresse de messagerie de l’utilisateur d’appartenance.(Remplace MembershipUser.Email.)

System_CAPS_pubpropertyIsApproved

Obtient ou définit une valeur qui indique si l’utilisateur d’appartenance peut être authentifié.(Remplace MembershipUser.IsApproved.)

System_CAPS_pubpropertyIsLockedOut

Obtient une valeur indiquant si l’utilisateur d’appartenance est verrouillé et impossible à valider.(Hérité de MembershipUser.)

System_CAPS_pubpropertyIsOnline

Détermine si l’utilisateur est actuellement en ligne.(Hérité de MembershipUser.)

System_CAPS_pubpropertyLastActivityDate

Lève une NotSupportedException exception dans tous les cas(Remplace MembershipUser.LastActivityDate.)

System_CAPS_pubpropertyLastLockoutDate

Obtient la date et l’heure du dernier verrouillage de l’utilisateur d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubpropertyLastLoginDate

Lève une exception NotSupportedException dans tous les cas.(Remplace MembershipUser.LastLoginDate.)

System_CAPS_pubpropertyLastPasswordChangedDate

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.)

System_CAPS_pubpropertyPasswordQuestion

Obtient la question du mot de passe pour l’utilisateur d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubpropertyProviderName

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.)

System_CAPS_pubpropertyProviderUserKey

Obtient l’identificateur d’utilisateur à partir du magasin de données Active Directory pour l’utilisateur d’appartenance.(Remplace MembershipUser.ProviderUserKey.)

System_CAPS_pubpropertyUserName

Obtient le nom de connexion de l’utilisateur d’appartenance.(Hérité de MembershipUser.)

NomDescription
System_CAPS_pubmethodChangePassword(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.)

System_CAPS_pubmethodChangePasswordQuestionAndAnswer(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.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetPassword()

Obtient le mot de passe pour l’utilisateur d’appartenance dans le magasin de données d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubmethodGetPassword(String)

Obtient le mot de passe pour l’utilisateur d’appartenance à partir du magasin de données d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodResetPassword()

Réinitialise le mot de passe d’un utilisateur et affecte un nouveau mot de passe généré automatiquement.(Hérité de MembershipUser.)

System_CAPS_pubmethodResetPassword(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.)

System_CAPS_pubmethodToString()

Retourne le nom d’utilisateur de l’utilisateur d’appartenance.(Hérité de MembershipUser.)

System_CAPS_pubmethodUnlockUser()

Efface l’état verrouillé de l’utilisateur pour que l’utilisateur d’appartenance puisse être validé.(Hérité de MembershipUser.)

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

Un ActiveDirectoryMembershipUser 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 des données différentes stocke, 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 le ActiveDirectoryMembershipUser objet n’implémente pas le LastActivityDate et LastLoginDate Propriétés, vous devez être préparé à gérer le NotSupportedException qui est levée lorsque ces membres sont accessibles dans 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 des attributs qui se produisent lors de l’appel du UpdateUser (méthode). Il sérialise également le SecurityIdentifier représentation (disponibles dans le ProviderUserKey propriété) afin qu’un ActiveDirectoryMembershipUser objet pouvant être sérialisé et désérialisé sans lever d’exception.

A ActiveDirectoryMembershipUser est retourné par la GetUser et CreateUser méthodes ou dans le cadre d’un MembershipUserCollection retourné par le GetAllUsers, FindUsersByName, et FindUsersByEmail méthodes.

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

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

Property

Attribut de répertoire 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é de questions-réponses pour la réinitialisation de mot de passe ou la récupération.

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 lockoutTime et la durée de verrouillage AD (AD sur Windows 2000)

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

msDS-User-Account-Control-Computed (ADAM)

Non

LastLockoutDate

Si verrouillé en raison de trop nombreuses tentatives de mot de passe, l’attribut de durée de verrouillage est retourné.

Tentatives si verrouillé en raison d’une réponse de mot de passe incorrect un trop grand nombre, la valeur stockée dans l’attribut défini par attributeMapFailedPasswordAnswerLockoutTime est retourné.

Si verrouillé en raison d’un mot de passe incorrect et mot de passe incorrectes trop nombreuses tentatives, la valeur date/heure la plus récente est retournée.

Si le compte n’est pas verrouillé, retourne 1/1/1753 pour la compatibilité SQL.

Non

L’exemple de code suivant illustre l’utilisation de propriétés sur le ActiveDirectoryMembershipUser objet sur une page Web qui peut retourner des informations utilisateur à partir de plusieurs magasins de données d’appartenance. Étant donné que le ActiveDirectoryMembershipUser objet sous-jacent le MembershipUser objet retourné par le fournisseur d’appartenances n’implémente pas le LastActivityDate et LastLoginDate Propriétés, 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;

    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
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: