Bagikan melalui


DirectorySearcher Kelas

Definisi

Melakukan kueri terhadap Active Directory Domain Services.

public ref class DirectorySearcher : System::ComponentModel::Component
public class DirectorySearcher : System.ComponentModel.Component
[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Component
type DirectorySearcher = class
    inherit Component
[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
    inherit Component
Public Class DirectorySearcher
Inherits Component
Warisan
DirectorySearcher
Atribut

Keterangan

DirectorySearcher Gunakan objek untuk mencari dan melakukan kueri terhadap hierarki Active Directory Domain Services menggunakan Lightweight Directory Access Protocol (LDAP). LDAP adalah satu-satunya penyedia Antarmuka Layanan Direktori Aktif (ADSI) yang disediakan sistem yang mendukung pencarian direktori. Administrator dapat membuat, mengubah, dan menghapus objek yang ditemukan dalam hierarki. Untuk informasi selengkapnya, lihat Menggunakan System.DirectoryServices.

Saat Anda membuat instans DirectorySearcher, Anda menentukan akar yang ingin Anda ambil, dan daftar properti opsional untuk diambil. Properti SearchRoot memungkinkan Anda mengatur properti tambahan untuk melakukan tugas berikut:

  • Cache hasil pencarian di komputer lokal. Atur properti ke CacheResultstrue untuk menyimpan informasi direktori pada komputer lokal. Pembaruan dilakukan pada cache lokal ini dan berkomitmen untuk Active Directory Domain Services hanya ketika metode dipanggil DirectoryEntry.CommitChanges .

  • Tentukan lamanya waktu untuk mencari, menggunakan ServerTimeLimit properti .

  • Ambil nama atribut saja. Atur PropertyNamesOnly properti ke true untuk hanya mengambil nama atribut yang nilainya telah ditetapkan.

  • Lakukan pencarian halaman. Atur PageSize properti untuk menentukan jumlah maksimum objek yang dikembalikan dalam pencarian halaman. Jika Anda tidak ingin melakukan pencarian halaman, atur PageSize properti ke default nol.

  • Tentukan jumlah maksimum entri yang akan dikembalikan, menggunakan SizeLimit properti . Jika Anda mengatur SizeLimit properti ke default nol, default yang ditentukan server adalah 1000 entri.

Catatan

Jika jumlah maksimum entri dan batas waktu yang dikembalikan melebihi batasan yang diatur pada server, pengaturan server akan mengambil alih pengaturan komponen.

Untuk daftar nilai properti awal untuk instans DirectorySearcher kelas , lihat DirectorySearcher() konstruktor .

Catatan

Diasumsikan bahwa Anda memiliki pemahaman umum tentang Active Directory Domain Services sebelum menggunakan kelas ini. Untuk informasi selengkapnya, lihat gambaran System.DirectoryServices umum.

Konstruktor

DirectorySearcher()

Menginisialisasi instans DirectorySearcher baru kelas dengan nilai default.

DirectorySearcher(DirectoryEntry)

Menginisialisasi instans DirectorySearcher baru kelas menggunakan akar pencarian yang ditentukan.

DirectorySearcher(DirectoryEntry, String)

Menginisialisasi instans DirectorySearcher baru kelas dengan akar pencarian dan filter pencarian yang ditentukan.

DirectorySearcher(DirectoryEntry, String, String[])

Menginisialisasi instans DirectorySearcher baru kelas dengan akar pencarian, filter pencarian, dan properti yang ditentukan untuk diambil.

DirectorySearcher(DirectoryEntry, String, String[], SearchScope)

Menginisialisasi instans DirectorySearcher baru kelas dengan akar pencarian, filter pencarian, properti yang ditentukan untuk diambil, dan cakupan pencarian.

DirectorySearcher(String)

Menginisialisasi instans DirectorySearcher baru kelas dengan filter pencarian yang ditentukan.

DirectorySearcher(String, String[])

Menginisialisasi instans DirectorySearcher baru kelas dengan filter pencarian dan properti yang ditentukan untuk diambil.

DirectorySearcher(String, String[], SearchScope)

Menginisialisasi instans DirectorySearcher baru kelas dengan filter pencarian, properti yang ditentukan untuk diambil, dan cakupan pencarian.

Properti

Asynchronous

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pencarian dilakukan secara asinkron.

AttributeScopeQuery

Mendapatkan atau mengatur nama tampilan LDAP dari atribut nama yang dibedakan untuk dicari. Hanya satu atribut yang dapat digunakan untuk jenis pencarian ini.

CacheResults

Mendapatkan atau menetapkan nilai yang menunjukkan apakah hasilnya di-cache di komputer klien.

CanRaiseEvents

Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa.

(Diperoleh dari Component)
ClientTimeout

Mendapatkan atau mengatur jumlah waktu maksimum klien menunggu server mengembalikan hasil. Jika server tidak merespons dalam waktu ini, pencarian dibatalkan dan tidak ada hasil yang dikembalikan.

Container

IContainer Mendapatkan yang berisi Component.

(Diperoleh dari Component)
DerefAlias

Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana alias objek yang ditemukan selama pencarian harus diselesaikan.

DesignMode

Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain.

(Diperoleh dari Component)
DirectorySynchronization

Mendapatkan atau mengatur objek yang mewakili kontrol sinkronisasi direktori untuk digunakan dengan pencarian.

Events

Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component.

(Diperoleh dari Component)
ExtendedDN

Mendapatkan atau menetapkan nilai yang menunjukkan format nama yang dibedakan.

Filter

Mendapatkan atau menetapkan nilai yang menunjukkan string filter format Lightweight Directory Access Protocol (LDAP).

PageSize

Mendapatkan atau mengatur nilai yang menunjukkan ukuran halaman dalam pencarian halaman.

PropertiesToLoad

Mendapatkan nilai yang menunjukkan daftar properti yang akan diambil selama pencarian.

PropertyNamesOnly

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pencarian hanya mengambil nama atribut yang nilainya telah ditetapkan.

ReferralChasing

Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana rujukan dikejar.

SearchRoot

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

SearchScope

Mendapatkan atau menetapkan nilai yang menunjukkan cakupan pencarian yang diamati oleh server.

SecurityMasks

Mendapatkan atau menetapkan nilai yang menunjukkan informasi akses keamanan mana untuk atribut yang ditentukan yang harus dikembalikan oleh pencarian.

ServerPageTimeLimit

Mendapatkan atau menetapkan nilai yang menunjukkan jumlah waktu maksimum server harus mencari halaman hasil individual. Ini tidak sama dengan batas waktu untuk seluruh pencarian.

ServerTimeLimit

Properti ServerTimeLimit mendapatkan atau menetapkan nilai yang menunjukkan jumlah waktu maksimum yang dihabiskan server untuk pencarian. Jika batas waktu tercapai, hanya entri yang ditemukan hingga titik tersebut yang dikembalikan.

Site

Mendapatkan atau mengatur ISite dari Component.

(Diperoleh dari Component)
SizeLimit

Mendapatkan atau menetapkan nilai yang menunjukkan jumlah maksimum objek yang dikembalikan server dalam pencarian.

Sort

Mendapatkan atau menetapkan nilai yang menunjukkan properti tempat hasil diurutkan.

Tombstone

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pencarian juga harus mengembalikan objek yang dihapus yang cocok dengan filter pencarian.

VirtualListView

Mendapatkan atau menetapkan nilai yang menunjukkan opsi tampilan daftar virtual untuk pencarian.

Metode

CreateObjRef(Type)

Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh.

(Diperoleh dari MarshalByRefObject)
Dispose()

Merilis semua sumber daya yang Componentdigunakan oleh .

(Diperoleh dari Component)
Dispose(Boolean)

Merilis sumber daya terkelola yang digunakan oleh DirectorySearcher objek dan, secara opsional, merilis sumber daya yang tidak dikelola.

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindAll()

Menjalankan pencarian dan mengembalikan kumpulan entri yang ditemukan.

FindOne()

Menjalankan pencarian dan hanya mengembalikan entri pertama yang ditemukan.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetLifetimeService()
Kedaluwarsa.

Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini.

(Diperoleh dari MarshalByRefObject)
GetService(Type)

Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container.

(Diperoleh dari Component)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
InitializeLifetimeService()
Kedaluwarsa.

Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini.

(Diperoleh dari MarshalByRefObject)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
MemberwiseClone(Boolean)

Membuat salinan dangkal objek saat ini MarshalByRefObject .

(Diperoleh dari MarshalByRefObject)
ToString()

Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa.

(Diperoleh dari Component)

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode .

(Diperoleh dari Component)

Berlaku untuk

Lihat juga