DirectorySearcher.SearchRoot Properti

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Sumber:

DirectorySearcher.cs

Mendapatkan atau mengatur nilai yang menunjukkan simpul dalam hierarki Active Directory Domain Services tempat pencarian dimulai.

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

Nilai Properti

DirectoryEntry

Objek DirectoryEntry dalam hierarki Active Directory Domain Services tempat pencarian dimulai. Defaultnya adalah referensi null (Nothing di Visual Basic).

Keterangan

Jika SearchRoot adalah referensi null (Nothing di Visual Basic), akar pencarian diatur ke akar domain yang saat ini digunakan server Anda.

Ada beberapa cara untuk mencari di katalog global:

• Hitung katalog global dan pilih anak pertama.

• Tentukan nama server. Gunakan fungsi DsGetDcName untuk menemukan katalog global. Untuk informasi selengkapnya tentang fungsi DsGetDcName, lihat DsGetDcName.

• Dapatkan RootDSE katalog global dan minta "rootNamingContext".

• Gunakan katalog global, menentukan jalur pencarian seolah-olah menggunakan LDAP. Misalnya, "GC://OU=..., DC=..., DC=...".

• Kode C# berikut menunjukkan cara menghitung katalog global dan memilih anak pertama.

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