DirectorySearcher.SearchRoot Propriété

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Source:

DirectorySearcher.cs

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; }

member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valeur de propriété

DirectoryEntry

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).

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);