Condividi tramite


DirectorySearcher.AttributeScopeQuery Proprietà

Definizione

Ottiene o imposta il nome visualizzato LDAP dell'attributo con nome distinto in cui effettuare la ricerca. Per questo tipo di ricerca può essere utilizzato un solo attributo.

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

Valore della proprietà

Nome visualizzato LDAP dell'attributo su cui effettuare la ricerca o stringa vuota qualora non sia impostata una query relativa all'ambito dell'attributo.

Attributi

Eccezioni

La proprietà SearchScope è impostata su un valore diverso da Base.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la AttributeScopeQuery proprietà con l'attributo membro per ottenere i membri di un gruppo. Stampa quindi il nome e il cognome dei membri e i relativi numeri di telefono.

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

Commenti

L'attributo impostato su questa proprietà deve essere un attributo name distinto, ad esempio membro o managedBy. L'attributo può essere singolo o multivalore. Per altre informazioni, vedere gli articoli Membri e Managed-By .

La ricerca viene eseguita sugli oggetti identificati dal nome distinto specificato nell'attributo dell'oggetto di base. Ad esempio, se l'oggetto di base è una classe di gruppo adschema e l'oggetto AttributeScopeQuery è impostato su "membro", la ricerca verrà eseguita su tutti gli oggetti membri del gruppo. Per altre informazioni, vedere l'articolo Classe Group .

Quando viene utilizzata la AttributeScopeQuery proprietà , la SearchScope proprietà deve essere impostata su Base. Se la SearchScope proprietà è impostata su qualsiasi altro valore, l'impostazione della AttributeScopeQuery proprietà genererà un'eccezione ArgumentException.

Per altre informazioni, vedere Esecuzione di una query sull'ambito dell'attributo.

Si applica a