DirectorySearcher.AttributeScopeQuery Egenskap

Definition

Namnområde:
System.DirectoryServices
Sammansättning:
System.DirectoryServices.dll
Paket:
System.DirectoryServices v11.0.0-preview.5.26302.115
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs
Källa:
DirectorySearcher.cs

Hämtar eller anger LDAP-visningsnamnet för det unika namnattributet som ska sökas in. Endast ett attribut kan användas för den här typen av sökning.

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

Egenskapsvärde

String

LDAP-visningsnamnet för attributet som ska utföra sökningen mot eller en tom sträng utan attributomfångsfråga har angetts.

Attribut
TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Undantag

ArgumentException

Egenskapen SearchScope är inställd på ett annat värde än Base.

Exempel

I följande exempel visas hur du använder AttributeScopeQuery egenskapen med medlemsattributet för att hämta medlemmar i en grupp. Den skriver sedan ut för- och efternamnen på medlemmarna och deras telefonnummer.

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

Kommentarer

Attributet som den här egenskapen är inställd på måste vara ett unikt namnattribut, till exempel medlem eller managedBy. Attributet kan vara antingen enstaka eller flervärdesvärde. Mer information finns i artiklarna Medlem och Hanterad av .

Sökningen utförs mot de objekt som identifieras med det unika namn som anges i -attributet för basobjektet. Om basobjektet till exempel är en adschemagruppklass och AttributeScopeQuery är inställt på "medlem" utförs sökningen mot alla objekt som är medlemmar i gruppen. Mer information finns i artikeln Gruppklass .

När egenskapen AttributeScopeQuery används SearchScope måste egenskapen anges till Base. Om egenskapen är inställd på SearchScope något annat värde utlöser inställningen AttributeScopeQuery egenskapen en ArgumentException.

Mer information finns i Frågan Om attributomfång.

Gäller för