DirectorySearcher.AttributeScopeQuery Eigenschap

Definitie

Naamruimte:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll

Hiermee wordt de LDAP-weergavenaam van het kenmerk DN-naam opgehaald of ingesteld om in te zoeken. Er kan slechts één kenmerk worden gebruikt voor dit type zoekopdracht.

public:
 property System::String ^ AttributeScopeQuery { System::String ^ get(); void set(System::String ^ value); };
[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; }
[<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

Waarde van eigenschap

String

De LDAP-weergavenaam van het kenmerk waarop de zoekopdracht moet worden uitgevoerd of een lege tekenreeks zonder kenmerkbereikquery is ingesteld.

Kenmerken
TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Uitzonderingen

ArgumentException

De SearchScope eigenschap is ingesteld op een andere waarde dan Base.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de AttributeScopeQuery eigenschap gebruikt met het kenmerk Lid om de leden van een groep op te halen. Vervolgens worden de voor- en achternamen van de leden en hun telefoonnummers afgedrukt.

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

Opmerkingen

Het kenmerk waarop deze eigenschap is ingesteld, moet een DN-naamkenmerk zijn, zoals lid of managedBy. Het kenmerk kan één of meerdere waarden bevatten. Zie de artikelen Lid en Beheerd door voor meer informatie.

De zoekopdracht wordt uitgevoerd op de objecten die worden geïdentificeerd door de DN-naam die is opgegeven in het kenmerk van het basisobject. Als het basisobject bijvoorbeeld een adschema-groepsklasse is en de AttributeScopeQuery groep is ingesteld op lid, wordt de zoekopdracht uitgevoerd op alle objecten die lid zijn van de groep. Zie het artikel Groepsklasse voor meer informatie.

Wanneer de AttributeScopeQuery eigenschap wordt gebruikt, moet de SearchScope eigenschap worden ingesteld op Base. Als de SearchScope eigenschap is ingesteld op een andere waarde, genereert het instellen van de AttributeScopeQuery eigenschap een ArgumentException.

Zie voor meer informatie het uitvoeren van een kenmerkbereikquery.

Van toepassing op