ActiveDirectoryMembershipUser Klasse

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Macht die in einem Active Directory-Datenspeicher gespeicherten Mitgliedschaftsbenutzerinformationen verfügbar und aktualisiert sie.

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

Vererbung: Object

MembershipUser
ActiveDirectoryMembershipUser

Attribute: SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung von Eigenschaften für das ActiveDirectoryMembershipUser -Objekt auf einer Webseite veranschaulicht, die Benutzerinformationen aus mehreren Mitgliedschaftsdatenspeichern zurückgeben kann. Da das ActiveDirectoryMembershipUser Objekt, das dem MembershipUser vom Mitgliedschaftsanbieter zurückgegebenen Objekt zugrunde liegt, die LastActivityDate Eigenschaften und LastLoginDate nicht implementiert, überprüft der Code zunächst den Typ des Vom Mitgliedschaftsanbieter zurückgegebenen Benutzerobjekts, bevor der Inhalt dieser Eigenschaften angezeigt wird.


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

Hinweise

Das ActiveDirectoryMembershipUser -Objekt wird verwendet, um einen einzelnen Mitgliedschaftsbenutzer im Active Directory-Mitgliedschaftsdatenspeicher darzustellen. Es macht Informationen über den Mitgliedschaftsbenutzer verfügbar, z. B. die E-Mail-Adresse, und bietet Funktionen für den Mitgliedschaftsbenutzer, z. B. die Möglichkeit, sein Kennwort zu ändern oder zurückzusetzen.

Ein ActiveDirectoryMembershipUser -Objekt wird vom Mitgliedschaftsanbieter der Anwendung zurückgegeben, wenn die Anwendung für die Verwendung eines Active Directory-Datenspeichers konfiguriert ist. In einer Anwendung, die für die Verwendung verschiedener Datenspeicher konfiguriert werden kann, oder in einer Anwendung, die mehrere Datenspeicher verwendet, können Sie auf die Basisklasse MembershipUserverweisen. Da das ActiveDirectoryMembershipUser -Objekt die LastActivityDate Eigenschaften und LastLoginDate nicht implementiert, müssen Sie bereit sein, den zu verarbeiten, der NotSupportedException ausgelöst wird, wenn auf diese Member für ein ActiveDirectoryMembershipUser Objekt zugegriffen wird.

Die ActiveDirectoryMembershipUser -Klasse implementiert interne Optimierungen, die von der ActiveDirectoryMembershipProvider -Klasse verwendet werden, um die Anzahl der Attributupdates zu minimieren, die beim Aufrufen der UpdateUser -Methode auftreten. Außerdem wird die Darstellung (in der SecurityIdentifier ProviderUserKey -Eigenschaft verfügbar) serialisiert, sodass ein ActiveDirectoryMembershipUser Objekt serialisiert und deserialisiert werden kann, ohne Dass Ausnahmen ausgelöst werden.

Ein ActiveDirectoryMembershipUser -Objekt wird von den GetUser Methoden und CreateUser oder als Teil eines MembershipUserCollection zurückgegeben von den GetAllUsersMethoden , FindUsersByNameund FindUsersByEmail zurückgegeben.

Ein ActiveDirectoryMembershipUser -Objekt ist für die UpdateUser -Methode erforderlich, wenn Sie die Informationen für einen vorhandenen Mitgliedschaftsbenutzer aktualisieren möchten.

ActiveDirectoryMembershipUser Eigenschaften werden Active Directory-Attributen zugeordnet. In der folgenden Tabelle sind die ActiveDirectoryMembershipUser Eigenschaften und die zugehörigen Standardattributezuordnungen aufgeführt.

Eigenschaft	Standardverzeichnis-Attribut	Kann zugeordnet werden?
ProviderUserKey	`securityIdentifier`	Nein
UserName	`userPrincipalName`	Ja, muss aber entweder userPrincipalName oder sAMAccountName sein.
Comment	`comment`	Nein
CreationDate	`whenCreated`	Nein
Email	`mail`	Ja, aber muss ein einwertiges Attribut vom Typ Unicode String sein.
LastActivityDate	–	Wird von ActiveDirectoryMembershipProvidernicht unterstützt.
LastLoginDate	–	Wird von ActiveDirectoryMembershipProvidernicht unterstützt.
LastPasswordChangedDate	`pwdLastSet`	Nein
PasswordQuestion	keine, muss jedoch einem Attribut zugeordnet werden, wenn Sie die Frage-und-Antwort-Sicherheit für die Kennwortzurücksetzung oder den Kennwortabruf verwenden.	Ja, aber muss ein einwertiges Attribut vom Typ Unicode String sein.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	Nein
IsLockedOut	berechnet aus `lockoutTime` und der AD-Sperrdauer (AD unter Windows 2000) `msDS-User-Account-Control-Computed` (AD unter Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	Nein
LastLockoutDate	Wenn sie aufgrund zu vieler fehlerhafter Kennwortversuche gesperrt wurde, wird das Sperrzeit-Attribut zurückgegeben. Wenn sie aufgrund zu vieler fehlerhafter Kennwortantwortversuche gesperrt werden, wird der wert zurückgegeben, der im von definierten `attributeMapFailedPasswordAnswerLockoutTime` Attribut gespeichert ist. Wenn sie aufgrund eines ungültigen Kennworts und zu vieler fehlerhafter Kennwortversuche gesperrt sind, wird der letzte Datums-/Uhrzeitwert zurückgegeben. Wenn das Konto nicht gesperrt ist, geben Sie 1/1/1753 aus Gründen der SQL-Kompatibilität zurück.	Nein

Konstruktoren

ActiveDirectoryMembershipUser()	Initialisiert eine neue Instanz eines ActiveDirectoryMembershipUser-Objekts für eine Klasse, die die ActiveDirectoryMembershipUser-Klasse erbt.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Erstellt eine neue Instanz der ActiveDirectoryMembershipUser-Klasse mit den angegebenen Eigenschaftswerten.

Eigenschaften

Comment	Ruft anwendungsspezifische Informationen für den Mitgliedschaftsbenutzer ab oder legt diese fest.
CreationDate	Ruft das Datum und die Uhrzeit der Hinzufügung des Benutzers zum Mitgliedschaftsdatenspeicher ab. (Geerbt von MembershipUser)
Email	Ruft die E-Mail-Adresse des Mitgliedschaftsbenutzers ab oder legt diese fest.
IsApproved	Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsbenutzer authentifiziert werden kann, oder legt diesen fest.
IsLockedOut	Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsbenutzer gesperrt ist und nicht überprüft werden kann. (Geerbt von MembershipUser)
IsOnline	Ruft ab, ob der Benutzer derzeit online ist. (Geerbt von MembershipUser)
LastActivityDate	Löst in allen Fällen eine NotSupportedException-Ausnahme aus.
LastLockoutDate	Ruft das Datum und die Uhrzeit der letzten Sperrung des Mitgliedschaftsbenutzers ab. (Geerbt von MembershipUser)
LastLoginDate	Löst in allen Fällen eine NotSupportedException-Ausnahme aus.
LastPasswordChangedDate	Ruft Datum und Uhrzeit der letzten Aktualisierung des Kennworts eines Mitgliedschaftsbenutzers ab. (Geerbt von MembershipUser)
PasswordQuestion	Ruft die Kennwortfrage für den Mitgliedschaftsbenutzer ab. (Geerbt von MembershipUser)
ProviderName	Ruft den Namen des Mitgliedschaftsanbieters ab, der Benutzerinformationen für den Mitgliedschaftsbenutzer abruft und speichert. (Geerbt von MembershipUser)
ProviderUserKey	Ruft den Bezeichner des Benutzers für den Mitgliedschaftsbenutzer aus dem Active Directory-Datenspeicher ab.
UserName	Ruft den Anmeldenamen des Mitgliedschaftsbenutzers ab. (Geerbt von MembershipUser)

Methoden

ChangePassword(String, String)	Aktualisiert das Kennwort für den Mitgliedschaftsbenutzer im Mitgliedschaftsdatenspeicher. (Geerbt von MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Aktualisiert die Kennwortfrage und -antwort für den Mitgliedschaftsbenutzer im Mitgliedschaftsdatenspeicher. (Geerbt von MembershipUser)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPassword()	Ruft das Kennwort für den Mitgliedschaftsbenutzer aus dem Mitgliedschaftsdatenspeicher ab. (Geerbt von MembershipUser)
GetPassword(String)	Ruft das Kennwort für den Mitgliedschaftsbenutzer aus dem Mitgliedschaftsdatenspeicher ab. (Geerbt von MembershipUser)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ResetPassword()	Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück. (Geerbt von MembershipUser)
ResetPassword(String)	Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück. (Geerbt von MembershipUser)
ToString()	Gibt den Benutzernamen für den Mitgliedschaftsbenutzer zurück. (Geerbt von MembershipUser)
UnlockUser()	Hebt die Sperre für den Benutzer auf, damit der Mitgliedschaftsbenutzer überprüft werden kann. (Geerbt von MembershipUser)

Gilt für:

Weitere Informationen

Einführung in die Mitgliedschaft

Freigeben über