DirectorySearcher.SearchRoot Eigenschaft

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

DirectorySearcher.cs

Ruft einen Wert ab, der den Knoten in der Active Directory-Domänendienste-Hierarchie angibt, bei dem die Suche beginnt, oder legt diesen fest.

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

Eigenschaftswert

DirectoryEntry

Das DirectoryEntry-Objekt in der Active Directory-Domänendienste-Hierarchie, an dem die Suche begonnen wird. Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Wenn SearchRoot ein NULL-Verweis (Nothing in Visual Basic) ist, wird der Suchstamm auf den Stamm der Domäne festgelegt, die ihr Server derzeit verwendet.

Es gibt mehrere Möglichkeiten, im globalen Katalog zu suchen:

• Auflisten Sie den globalen Katalog, und wählen Sie das erste untergeordnete Element aus.

• Geben Sie den Servernamen an. Verwenden Sie die DsGetDcName-Funktion, um den globalen Katalog zu suchen. Weitere Informationen zur DsGetDcName-Funktion finden Sie unter DsGetDcName.

• Rufen Sie den RootDSE des globalen Katalogs ab, und fragen Sie nach "rootNamingContext".

• Verwenden Sie den globalen Katalog, und geben Sie einen Suchpfad an, als ob sie LDAP verwenden würden. Beispiel: "GC://OU=..., DC=..., DC=...".

• Der folgende C#-Code zeigt, wie Sie den globalen Katalog auflisten und das erste untergeordnete Element auswählen.

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