DirectorySearcher.AttributeScopeQuery Propriété

Référence

Définition

Espace de noms:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Paquet:: System.DirectoryServices v6.0.0

Paquet:: System.DirectoryServices v7.0.0

Paquet:: System.DirectoryServices v8.0.0

Paquet:: System.DirectoryServices v9.0.0-preview.2.24128.5

Source:: DirectorySearcher.cs

Source:: DirectorySearcher.cs

Source:: DirectorySearcher.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nom complet LDAP de l'attribut de nom unique dans lequel effectuer une recherche. Un seul attribut peut être utilisé pour ce type de recherche.

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

Valeur de propriété

String

Nom complet LDAP de l'attribut dans lequel effectuer la recherche ou chaîne vide si aucune requête de portée d'attribut n'est définie.

Attributs: TypeConverterAttribute DSDescriptionAttribute ComVisibleAttribute

Exceptions

ArgumentException

La propriété SearchScope a une valeur différente de Base.

Exemples

L’exemple suivant montre comment utiliser la AttributeScopeQuery propriété avec l’attribut membre pour obtenir les membres d’un groupe. Il imprime ensuite le prénom et le nom des membres et leurs numéros de téléphone.

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

Remarques

L’attribut sur lequel cette propriété est définie doit être un attribut de nom unique, tel que member ou managedBy. L’attribut peut être unique ou à valeurs multiples. Pour plus d’informations, consultez les articles Membre et Managed-By .

La recherche est effectuée sur les objets identifiés par le nom unique spécifié dans l’attribut de l’objet de base. Par exemple, si l’objet de base est une classe de groupe adschema et que le AttributeScopeQuery est défini sur « membre », la recherche est effectuée sur tous les objets membres du groupe. Pour plus d’informations, consultez l’article Classe de groupe .

Lorsque la AttributeScopeQuery propriété est utilisée, la SearchScope propriété doit être définie sur Base. Si la SearchScope propriété est définie sur une autre valeur, la définition de la AttributeScopeQuery propriété lève un ArgumentException.

Pour plus d’informations, consultez Exécution d’une requête d’étendue d’attribut.

S’applique à

Partager via