PrincipalSearcher.FindOne Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

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

Źródło:

PrincipalSearcher.cs

Zwraca główny wynik wyszukiwania zawierający pierwszy obiekt podmiotu zabezpieczeń, który jest zgodny z podmiotem zabezpieczeń określonym we QueryFilter właściwości.

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

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

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

Public Function FindOne () As Principal

Zwraca

Principal

Principal Obiekt zawierający obiekt zabezpieczeń zgodny z filtrem zapytania lub null jeśli nie zostaną znalezione żadne wyniki.

Wyjątki

InvalidOperationException

Zawiera QueryFilter właściwości odwołania. Aby uzyskać więcej informacji, zobacz temat Omówienie zapytania według przykładu .

Jest QueryFilter to utrwalone podmioty zabezpieczeń.

ArgumentException

Przed QueryFilter wykonaniem zapytania należy najpierw przypisać element do głównego wyszukiwania.

Uwagi

Jeśli w obiekcie QueryFilterokreślono dokładnie jedno dopasowanie obiektu , ta metoda zwraca ten obiekt. Jeśli istnieje wiele dopasowań QueryFilter obiektu, ta metoda arbitralnie zwraca jedną z pasujących podmiotów zabezpieczeń.

Obiekt Principal zwrócony z tej metody odpowiada typowi obiektu zawartego QueryFilter we właściwości. Wyszukiwanie jest przeprowadzane w kontekście określonym we Context właściwości. Aby uzyskać więcej informacji, zobacz temat Omówienie zapytania według przykładu .

Zobacz też

• Zapytanie według przykładu