DirectorySearcher.AttributeScopeQuery Özellik

Başvuru

Tanım

Ad Alanı:: System.DirectoryServices

Bütünleştirilmiş Kod:: 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

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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; }

[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

Özellik Değeri

String

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

Öznitelikler: TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Ö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.

Şunlara uygulanır

Aracılığıyla paylaş