Principal.FindByIdentity Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Gibt ein Prinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.

Überlädt

FindByIdentity(PrincipalContext, String)	Gibt ein Prinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.
FindByIdentity(PrincipalContext, IdentityType, String)	Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity(PrincipalContext, IdentityType, String)-Methode bestimmt das Format des Identitätswerts.

FindByIdentity(PrincipalContext, String)

Quelle:

Principal.cs

Gibt ein Prinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.

public:
 static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.Principal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As Principal

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityValue

String

Die Identität des Prinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

Principal

Ein Principal-Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Prinzipalobjekte gefunden, die dem aktuellen Objekt entsprechen.

FindByIdentity(PrincipalContext, IdentityType, String)

Quelle:

Principal.cs

Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity(PrincipalContext, IdentityType, String)-Methode bestimmt das Format des Identitätswerts.

public:
 static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.Principal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Principal

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityType

IdentityType

Ein IdentityType-Enumerationswert, der das Format des identityValue-Parameters angibt.

identityValue

String

Die Identität des Prinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

Principal

Ein Principal-Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Prinzipalobjekte gefunden, die dem aktuellen Objekt entsprechen.

InvalidEnumArgumentException

Der Identitätstyp ist kein gültiger IdentityType-Enumerationswert.