DirectorySearcher.AttributeScopeQuery Özellik

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Kaynak:

DirectorySearcher.cs

Aranacak ayırt edici ad özniteliğinin LDAP görünen adını alır veya ayarlar. Bu tür arama 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

Üzerinde arama yapmak için özniteliğin LDAP görünen adı veya öznitelik kapsamı sorgusu ayarlanmadı boş bir dize.

Ö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 adlarını 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. Özniteliği 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 nesnelere karşı gerçekleştirilir. Daha fazla bilgi için Grup sınıfı makalesine bakın.

AttributeScopeQuery özelliği kullanıldığında özelliği SearchScope olarak Baseayarlanmalıdır. 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.