DirectorySearcher.AttributeScopeQuery Özellik

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Kaynak:

DirectorySearcher.cs

Aranacak ayırt edici ad özniteliğinin LDAP görünen adını alır veya ayarlar. Bu arama türü için yalnızca bir öznitelik kullanılabilir.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };

public string AttributeScopeQuery { get; set; }

member this.AttributeScopeQuery : string with get, set

Public Property AttributeScopeQuery As String

Özellik Değeri

String

Aramanın yapılacağı özniteliğin LDAP görünen adı veya öznitelik kapsamı sorgusu olmayan boş bir dize ayarlanmadı.

Özel durumlar

ArgumentException

SearchScope özelliği dışında Basebir değere ayarlanır.

Örnekler

Aşağıdaki örnekte, bir grubun üyelerini AttributeScopeQuery almak için member özniteliğiyle özelliğinin nasıl kullanılacağı gösterilmektedir. Ardından üyelerin ad ve soyadlarını ve telefon numaralarını yazdırır.

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("…");  
        }
    }
}

Açıklamalar

Bu özelliğin ayarlandığı öznitelik, member veya managedBy gibi ayırt edici bir ad özniteliği olmalıdır. Öznitelik tek veya çok değerli olabilir. Daha fazla bilgi için Üye ve Yönetilen makalelerine bakın.

Arama, temel nesnenin özniteliğinde belirtilen ayırt edici adla tanımlanan nesnelere karşı gerçekleştirilir. Örneğin, temel nesne bir adschema grup sınıfıysa ve AttributeScopeQuery "üye" olarak ayarlandıysa, arama grubun üyesi olan tüm nesnelerde gerçekleştirilir. Daha fazla bilgi için Grup sınıfı makalesine bakın.

AttributeScopeQuery özelliği kullanıldığında özelliği olarak SearchScope ayarlanmalıdırBase. SearchScope Özellik başka bir değere ayarlanırsa, özelliği ayarlandığında AttributeScopeQuery bir ArgumentExceptionoluşturulur.

Daha fazla bilgi için bkz . Öznitelik Kapsamı Sorgusu Gerçekleştirme.