PrincipalSearcher.FindOne Methode

Referenz

Definition

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Paket:: System.DirectoryServices.AccountManagement v8.0.0

Paket:: System.DirectoryServices.AccountManagement v9.0.0-preview.4.24266.19

Quelle:: PrincipalSearcher.cs

Quelle:: PrincipalSearcher.cs

Quelle:: PrincipalSearcher.cs

Quelle:: PrincipalSearcher.cs

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.

Gibt das erste gefundene Prinzipalobjekt im Suchergebnis zurück, das mit dem Prinzipal übereinstimmt, der in der QueryFilter-Eigenschaft angegeben wurde.

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();

public System.DirectoryServices.AccountManagement.Principal FindOne ();

[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();

member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

Public Function FindOne () As Principal

Gibt zurück

Principal

Ein Principal -Objekt, das das Prinzipalobjekt enthält, das dem Abfragefilter entspricht, oder null wenn keine Ergebnisse gefunden werden.

Attribute: SecurityCriticalAttribute

Ausnahmen

InvalidOperationException

Der QueryFilter Verweiseigenschaften. Weitere Informationen finden Sie im Übersichtsartikel Query by Example.

Der QueryFilter ist ein beibehaltener Prinzipal.

ArgumentException

Bevor eine Abfrage erfolgen kann, muss zunächst ein QueryFilter für die Prinzipalsuche zugewiesen werden.

Hinweise

Wenn genau eine Übereinstimmung des im QueryFilterangegebenen -Objekts vorhanden ist, gibt diese Methode dieses Objekt zurück. Wenn mehrere Übereinstimmungen des QueryFilter Objekts vorhanden sind, gibt diese Methode willkürlich einen der übereinstimmenden Prinzipale zurück.

Das Principal von dieser Methode zurückgegebene Objekt stimmt mit dem Objekttyp überein, der in der QueryFilter -Eigenschaft enthalten ist. Die Suche wird in dem in der Context -Eigenschaft angegebenen Kontext durchgeführt. Weitere Informationen finden Sie im Übersichtsartikel Query by Example.

Gilt für:

Weitere Informationen

Abfrage nach Beispiel

Freigeben über