PrincipalSearcher.FindOne Methode
Definition
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
Ein Principal Objekt, das das Prinzipalobjekt enthält, das dem Abfragefilter entspricht oder null
wenn keine Ergebnisse gefunden werden.
- Attribute
Ausnahmen
Der QueryFilter Verweiseigenschaften. Weitere Informationen finden Sie im Übersichtsartikel Query by Example.
Der QueryFilter ist ein beibehaltener Prinzipal.
Bevor eine Abfrage erfolgen kann, muss zunächst ein QueryFilter für die Prinzipalsuche zugewiesen werden.
Hinweise
Wenn genau eine Übereinstimmung mit dem in QueryFilterangegebenen Objekt 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 entspricht dem Typ des in der QueryFilter -Eigenschaft enthaltenen Objekts. 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für