Partage via


DirectorySearcher.SearchRoot Propriété

Définition

Obtient ou définit une valeur qui indique le nœud dans la hiérarchie des services de domaine Active Directory où la recherche démarre.

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }
[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
Public Property SearchRoot As DirectoryEntry

Valeur de propriété

Objet DirectoryEntry de la hiérarchie des services de domaine Active Directory où la recherche démarre. La valeur par défaut est une référence Null (Nothing en Visual Basic).

Attributs

Remarques

Si SearchRoot est une référence null (Nothing en Visual Basic), la racine de recherche est définie sur la racine du domaine que votre serveur utilise actuellement.

Il existe plusieurs façons de rechercher dans le catalogue global :

  • Énumérez le catalogue global et choisissez le premier enfant.

  • Spécifiez le nom du serveur. Utilisez la fonction DsGetDcName pour rechercher le catalogue global. Pour plus d’informations sur la fonction DsGetDcName, consultez DsGetDcName.

  • Obtenez le RootDSE du catalogue global et demandez « rootNamingContext ».

  • Utilisez le catalogue global, en spécifiant un chemin de recherche comme si vous utilisiez LDAP. Par exemple, « GC://OU=..., DC=..., DC=....

  • Le code C# suivant montre comment énumérer le catalogue global et choisir le premier enfant.

    DirectoryEntry entry = new DirectoryEntry("GC://forestname");  
    IEnumerator ie = entry.Children.GetEnumerator();  
    ie.MoveNext();  
    entry = (DirectoryEntry)ie.Current;  
    DirectorySearcher search = new DirectorySearcher(entry);  
    

S’applique à