DirectorySearcher.AttributeScopeQuery Properti
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.
Mendapatkan atau mengatur nama tampilan LDAP dari atribut nama yang dibedakan untuk dicari. Hanya satu atribut yang dapat digunakan untuk jenis pencarian ini.
public:
property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };
public string AttributeScopeQuery { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSAttributeQuery")]
[System.Runtime.InteropServices.ComVisible(false)]
public string AttributeScopeQuery { get; set; }
[System.DirectoryServices.DSDescription("DSAttributeQuery")]
[System.Runtime.InteropServices.ComVisible(false)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string AttributeScopeQuery { get; set; }
member this.AttributeScopeQuery : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.DirectoryServices.DSDescription("DSAttributeQuery")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.AttributeScopeQuery : string with get, set
[<System.DirectoryServices.DSDescription("DSAttributeQuery")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.AttributeScopeQuery : string with get, set
Public Property AttributeScopeQuery As String
Nilai Properti
Nama tampilan LDAP atribut untuk melakukan pencarian, atau string kosong tanpa kueri cakupan atribut yang diatur.
- Atribut
Pengecualian
Properti SearchScope diatur ke nilai selain Base.
Contoh
Contoh berikut menunjukkan cara menggunakan AttributeScopeQuery properti dengan atribut anggota untuk mendapatkan anggota grup. Kemudian mencetak nama depan dan belakang anggota dan nomor telepon mereka.
using System;
using System.DirectoryServices;
public class Example
{
public static void Main()
{
DirectoryEntry group = new DirectoryEntry("LDAP://CN=MyGroup", …);
DirectorySearcher src = new DirectorySearcher("(&(objectClass=user)(objectCategory=Person))");
src.SearchRoot = group;
src.AttributeScopeQuery = "member";
src.PropertiesToLoad.Add("sn");
src.PropertiesToLoad.Add("givenName");
src.PropertiesToLoad.Add("telephoneNumber");
foreach(SearchResult res in src.FindAll())
{
Console.WriteLine("…");
}
}
}
Keterangan
Atribut yang diatur properti ini harus berupa atribut nama yang dibedakan, seperti anggota atau managedBy. Atribut dapat berupa tunggal atau multinilai. Untuk informasi selengkapnya, lihat artikel Anggota dan Dikelola Oleh .
Pencarian dilakukan terhadap objek yang diidentifikasi dengan nama khusus yang ditentukan dalam atribut objek dasar. Misalnya, jika objek dasar adalah kelas grup skema iklan dan AttributeScopeQuery diatur ke "anggota", maka pencarian akan dilakukan terhadap semua objek yang merupakan anggota grup. Untuk informasi selengkapnya, lihat artikel Kelas grup .
AttributeScopeQuery Ketika properti digunakan, SearchScope properti harus diatur ke Base. SearchScope Jika properti diatur ke nilai lain, mengatur AttributeScopeQuery properti akan melempar ArgumentException.
Untuk informasi selengkapnya, lihat Melakukan Kueri Cakupan Atribut.