DirectorySearcher.SearchRoot-Eigenschaft

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

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)

Syntax

'Declaration
Public Property SearchRoot As DirectoryEntry
'Usage
Dim instance As DirectorySearcher
Dim value As DirectoryEntry

value = instance.SearchRoot

instance.SearchRoot = value

public DirectoryEntry SearchRoot { get; set; }

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

/** @property */
public DirectoryEntry get_SearchRoot ()

/** @property */
public void set_SearchRoot (DirectoryEntry value)

public function get SearchRoot () : DirectoryEntry

public function set SearchRoot (value : DirectoryEntry)

Eigenschaftenwert

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

Hinweise

Wenn SearchRoot ein NULL-Verweis ist (Nothing in Visual Basic), wird die Stammsuche auf den Stamm der gegenwärtig vom Server verwendeten Domäne festgelegt.

Eine Suche im globalen Katalog kann auf verschiedene Arten durchgeführt werden:

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

• Geben Sie den Servernamen an. Verwenden Sie zum Suchen des globalen Katalogs die DsGetDcName-Funktion. Weitere Informationen über die DsGetDcName-Funktion finden Sie unter dem Thema "DsGetDcName" in der MSDN Library unter https://msdn.microsoft.com/library/deu (nur auf Englisch verfügbar).

• Rufen Sie die RootDSE des Katalogs ab, und fordern Sie "rootNamingContext" an.

• Verwenden Sie den globalen Katalog, indem Sie einen Suchpfad angeben, so als ob Sie LDAP verwenden würden. Beispiel: "GC://OU=..., DC=..., DC=...".

• Der folgende C#-Code veranschaulicht das Auflisten des globalen Katalogs und das Auswählen des ersten untergeordneten Elements.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DirectorySearcher-Klasse
DirectorySearcher-Member
System.DirectoryServices-Namespace