ActiveDirectoryMembershipProvider.GetUser Methode

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Ruft die Informationen von einem Mitgliedschaftsbenutzer im Active Directory-Datenspeicher ab.

Überlädt

GetUser(String, Boolean)	Ruft die dem angegebenen Benutzernamen zugeordneten Mitgliedschaftsbenutzerinformationen ab.
GetUser(Object, Boolean)	Ruft die dem angegebenen Benutzerschlüssel zugeordneten Mitgliedschaftsbenutzerinformationen ab.

GetUser(String, Boolean)

Ruft die dem angegebenen Benutzernamen zugeordneten Mitgliedschaftsbenutzerinformationen ab.

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::String ^ username, bool userIsOnline);

public override System.Web.Security.MembershipUser GetUser (string username, bool userIsOnline);

override this.GetUser : string * bool -> System.Web.Security.MembershipUser

Public Overrides Function GetUser (username As String, userIsOnline As Boolean) As MembershipUser

Parameter

username

String

Der Name des Benutzers, für den Informationen abgerufen werden sollen.

userIsOnline

Boolean

Die GetUser(String, Boolean)-Methode ignoriert diesen Parameter.

Gibt zurück

MembershipUser

Eine MembershipUser-Instanz, die den angegebenen Benutzer darstellt. Wenn im Active Directory-Datenspeicher für den angegebenen username-Wert kein Benutzer gefunden wird, wird null zurückgegeben.

Ausnahmen

ArgumentException

username ist leer oder übersteigt die maximale Länge für den Benutzernamen (i. d. R. 256 Zeichen).

- oder -

username enthält Kommas.

- oder -

Der Benutzername wird dem userPrincipalName-Attribut zugeordnet, und der username-Parameter enthält umgekehrte Schrägstriche.

ArgumentNullException

username ist null.

InvalidOperationException

Die GetUser(String, Boolean)-Methode wird aufgerufen, bevor die ActiveDirectoryMembershipProvider-Instanz initialisiert wird.

Hinweise

Die GetUser -Methode wird von der Membership -Klasse aufgerufen, um Informationen zum angegebenen Benutzer aus dem Active Directory-Datenspeicher abzurufen.

Der Anbieter verwendet eine Unterstruktursuche, die an dem in der Verbindungszeichenfolge angegebenen Suchpunkt beginnt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Thema der -Klasse.

Beim username-Parameterwert werden führende und nachstehende Leerzeichen abgeschnitten.

Weitere Informationen

• Einführung in ASP.NET Mitgliedschaft

GetUser(Object, Boolean)

Ruft die dem angegebenen Benutzerschlüssel zugeordneten Mitgliedschaftsbenutzerinformationen ab.

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey, bool userIsOnline);

public override System.Web.Security.MembershipUser GetUser (object providerUserKey, bool userIsOnline);

override this.GetUser : obj * bool -> System.Web.Security.MembershipUser

Public Overrides Function GetUser (providerUserKey As Object, userIsOnline As Boolean) As MembershipUser

Parameter

providerUserKey

Object

Der eindeutige Bezeichner für den Benutzer.

userIsOnline

Boolean

Die GetUser(Object, Boolean)-Methode ignoriert diesen Parameter.

Gibt zurück

MembershipUser

Eine MembershipUser-Instanz, die den angegebenen Benutzer darstellt. Wenn im Active Directory-Datenspeicher für den angegebenen providerUserKey-Wert kein Benutzer gefunden wird, wird null zurückgegeben.

Ausnahmen

InvalidOperationException

Die GetUser(Object, Boolean)-Methode wird aufgerufen, bevor die ActiveDirectoryMembershipProvider-Instanz initialisiert wird.

ArgumentException

providerUserKey ist nicht vom Typ SecurityIdentifier.

ArgumentNullException

providerUserKey ist null.

Hinweise

Die GetUser -Methode wird von der Membership -Klasse aufgerufen, um Informationen zum angegebenen Benutzer aus dem Active Directory-Datenspeicher abzurufen.

Die Suche sucht nach einer Benutzerinstanz, bei der das objectSID Attribut mit dem providerUserKey Parameter übereinstimmt.

Der Anbieter verwendet eine Unterstruktursuche, die an dem in der Verbindungszeichenfolge angegebenen Suchpunkt beginnt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Thema der -Klasse.