PrincipalSearcher.FindOne Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 ();
[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
Mengembalikan
Objek Principal yang berisi objek utama yang cocok dengan filter kueri atau null
jika tidak ada hasil yang ditemukan.
- Atribut
Pengecualian
QueryFilter berisi properti referensial. Untuk informasi selengkapnya, lihat topik Ringkasan Kueri menurut Contoh .
adalah QueryFilter prinsip yang bertahan.
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 .