PrincipalSearcher.FindOne Metode

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

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

Sumber:

PrincipalSearcher.cs

Mengembalikan hasil pencarian utama yang berisi objek utama pertama yang ditemukan yang cocok dengan prinsipal yang ditentukan dalam QueryFilter properti .

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

Mengembalikan

Principal

Objek Principal yang berisi objek utama yang cocok dengan filter kueri atau null jika tidak ada hasil yang ditemukan.

Pengecualian

InvalidOperationException

QueryFilter berisi properti referensial. Untuk informasi selengkapnya, lihat topik Ringkasan Kueri menurut Contoh .

adalah QueryFilter prinsip yang bertahan.

ArgumentException

A QueryFilter harus terlebih dahulu ditetapkan ke pencari utama sebelum kueri dapat dilakukan.

Keterangan

Jika ada tepat satu kecocokan objek yang ditentukan dalam , metode ini mengembalikan objek tersebut QueryFilter. Jika ada beberapa kecocokan QueryFilter objek, metode ini akan menampilkan salah satu prinsip yang cocok.

Objek Principal yang dikembalikan dari metode ini cocok dengan jenis objek yang terkandung dalam QueryFilter properti . Pencarian dilakukan dalam konteks yang ditentukan dalam Context properti . Untuk informasi selengkapnya, lihat topik Ringkasan Kueri menurut Contoh .

Lihat juga

• Kueri menurut Contoh