DirectorySearcher.SearchRoot Eigenschaft

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };

public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }

[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }

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

Eigenschaftswert

Das DirectoryEntry-Objekt in der Active Directory Domain Services Hierarchie, in der die Suche beginnt. Der Standardwert ist ein Nullverweis (Nothing in Visual Basic).

Attribute

DSDescriptionAttribute

Hinweise

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

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

• Auflisten des globalen Katalogs und Auswählen des ersten untergeordneten Elements

• Geben Sie den Servernamen an. Verwenden Sie die DsGetDcName-Funktion, um den globalen Katalog zu finden. 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. Beispiel: "GC://OU=..., DC=..., DC=...".

• Der folgende C#-Code zeigt, wie Sie den globalen Katalog aufzählen 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);