DirectorySearcher.AttributeScopeQuery Properti

Referensi

Definisi

Ruang nama:: System.DirectoryServices

Rakitan:: System.DirectoryServices.dll

Paket:: System.DirectoryServices v6.0.0

Paket:: System.DirectoryServices v7.0.0

Paket:: System.DirectoryServices v8.0.0

Paket:: System.DirectoryServices v9.0.0-preview.2.24128.5

Sumber:: DirectorySearcher.cs

Sumber:: DirectorySearcher.cs

Sumber:: DirectorySearcher.cs

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

String

Nama tampilan LDAP atribut untuk melakukan pencarian, atau string kosong tanpa kueri cakupan atribut yang diatur.

Atribut: TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Pengecualian

ArgumentException

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.

Berlaku untuk

Bagikan melalui