PrincipalSearcher.FindOne Yöntem

Tanım

Ad Alanı:

System.DirectoryServices.AccountManagement

Bütünleştirilmiş Kod:

System.DirectoryServices.AccountManagement.dll

Paket:

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

Kaynak:

PrincipalSearcher.cs

özelliğinde QueryFilter belirtilen sorumluyla eşleşen bulunan ilk asıl nesneyi içeren bir asıl arama sonucu döndürür.

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

Döndürülenler

Principal

Principal Sorgu filtresiyle eşleşen veya null hiçbir sonuç bulunamazsa asıl nesneyi içeren bir nesne.

Özel durumlar

InvalidOperationException

bilgi QueryFilter özellikleri içerir. Daha fazla bilgi için Örne göre sorguya genel bakış konusuna bakın.

QueryFilter kalıcı bir sorumludur.

ArgumentException

QueryFilter Sorgunun gerçekleştirilebilmesi için önce asıl arayıcıya atanması gerekir.

Açıklamalar

içinde QueryFilterbelirtilen nesnenin tam olarak bir eşleşmesi varsa, bu yöntem bu nesneyi döndürür. Nesnenin QueryFilter birden çok eşleşmesi varsa, bu yöntem rastgele olarak eşleşen sorumlulardan birini döndürür.

Principal Bu yöntemden döndürülen nesne özelliğinde bulunan nesne türüyle QueryFilter eşleşir. Arama özelliğinde belirtilen Context bağlamda yapılır. Daha fazla bilgi için Örne göre sorguya genel bakış konusuna bakın.

Ayrıca bkz.

• Örne Göre Sorgula