DirectorySearcher Kelas

Referensi

Definisi

Ruang nama:: System.DirectoryServices

Rakitan:: System.DirectoryServices.dll

Paket:: System.DirectoryServices v8.0.0

Paket:: System.DirectoryServices v9.0.0-rc.2.24473.5

Sumber:: DirectorySearcher.cs

Sumber:: DirectorySearcher.cs

Sumber:: DirectorySearcher.cs

Sumber:: DirectorySearcher.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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: Object

MarshalByRefObject

Component
DirectorySearcher

Atribut: DSDescriptionAttribute

Keterangan

Gunakan objek DirectorySearcher 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 CacheResults ke true untuk menyimpan informasi direktori di komputer lokal. Pembaruan dilakukan pada cache lokal ini dan berkomitmen untuk Active Directory Domain Services hanya ketika metode DirectoryEntry.CommitChanges dipanggil.
Tentukan lamanya waktu untuk mencari, menggunakan properti ServerTimeLimit.
Ambil nama atribut saja. Atur properti PropertyNamesOnly ke true untuk mengambil hanya nama atribut yang nilainya telah ditetapkan.
Lakukan pencarian halaman. Atur properti PageSize untuk menentukan jumlah maksimum objek yang dikembalikan dalam pencarian halaman. Jika Anda tidak ingin melakukan pencarian halaman, atur properti PageSize ke default nol.
Tentukan jumlah maksimum entri yang akan dikembalikan, menggunakan properti SizeLimit. Jika Anda mengatur properti SizeLimit ke default nol, default yang ditentukan server adalah 1000 entri.

Nota

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 kelas DirectorySearcher, lihat konstruktor DirectorySearcher().

Nota

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

Konstruktor

DirectorySearcher()	Menginisialisasi instans baru kelas DirectorySearcher dengan nilai default.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	Menginisialisasi instans baru kelas DirectorySearcher dengan akar pencarian, filter pencarian, properti yang ditentukan untuk diambil, dan cakupan pencarian.
DirectorySearcher(DirectoryEntry, String, String[])	Menginisialisasi instans baru kelas DirectorySearcher dengan akar pencarian, filter pencarian, dan properti yang ditentukan untuk diambil.
DirectorySearcher(DirectoryEntry, String)	Menginisialisasi instans baru kelas DirectorySearcher dengan akar pencarian dan filter pencarian yang ditentukan.
DirectorySearcher(DirectoryEntry)	Menginisialisasi instans baru kelas DirectorySearcher menggunakan akar pencarian yang ditentukan.
DirectorySearcher(String, String[], SearchScope)	Menginisialisasi instans baru kelas DirectorySearcher dengan filter pencarian, properti yang ditentukan untuk diambil, dan cakupan pencarian.
DirectorySearcher(String, String[])	Menginisialisasi instans baru kelas DirectorySearcher dengan filter pencarian dan properti yang ditentukan untuk diambil.
DirectorySearcher(String)	Menginisialisasi instans baru kelas DirectorySearcher dengan filter pencarian yang ditentukan.

Properti

Asynchronous	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pencarian dilakukan secara asinkron.
AttributeScopeQuery	Mendapatkan atau mengatur nama tampilan LDAP dari atribut nama khusus 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	Mendapatkan IContainer 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 Componentini. (Diperoleh dari Component)
ExtendedDN	Mendapatkan atau menetapkan nilai yang menunjukkan format nama khusus.
Filter	Mendapatkan atau menetapkan nilai yang menunjukkan string filter format Lightweight Directory Access Protocol (LDAP).
PageSize	Mendapatkan atau menetapkan 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 maksimum waktu yang dihabiskan server untuk pencarian. Jika batas waktu tercapai, hanya entri yang ditemukan hingga titik tersebut yang dikembalikan.
Site	Mendapatkan atau mengatur ISite 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 digunakan oleh Component. (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya terkelola yang digunakan oleh objek DirectorySearcher 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 Type instans 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 Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan String yang berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

Acara

Disposed

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

(Diperoleh dari Component)

Berlaku untuk

Bagikan melalui