DirectorySearcher.SearchRoot Eigenschap

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

Waarde van eigenschap

Het DirectoryEntry-object in de Active Directory Domain Services hiërarchie waar de zoekopdracht wordt gestart. De standaardwaarde is een null-verwijzing (Nothing in Visual Basic).

Kenmerken

DSDescriptionAttribute

Opmerkingen

Als SearchRoot een null-verwijzing is (Nothing in Visual Basic), wordt de zoekhoofdmap ingesteld op de hoofdmap van het domein dat uw server momenteel gebruikt.

Er zijn verschillende manieren om te zoeken in de globale catalogus:

• Inventariseer de globale catalogus en kies het eerste onderliggende item.

• Geef de servernaam op. Gebruik de functie DsGetDcName om de globale catalogus te vinden. Zie de DsGetDcName-functie voor meer informatie over de functie DsGetDcName.

• Haal de RootDSE van de globale catalogus op en vraag om rootNamingContext.

• Gebruik de globale catalogus en geef een zoekpad op alsof u LDAP gebruikt. Bijvoorbeeld 'GC://OU=..., DC=..., DC=...'.

• De volgende C#-code laat zien hoe u de globale catalogus opsommen en het eerste onderliggende item kiest.

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