DirectorySearcher Kelas

Referensi

Definisi

Ruang nama:: System.DirectoryServices

Rakitan:: System.DirectoryServices.dll

Paket:: System.DirectoryServices v6.0.0

Paket:: System.DirectoryServices v7.0.0

Paket:: System.DirectoryServices v8.0.0

Paket:: System.DirectoryServices v9.0.0-preview.2.24128.5

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

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. Updates dibuat untuk cache lokal ini dan berkomitmen untuk Active Directory Domain Services hanya ketika metode dipanggilDirectoryEntry.CommitChanges.
Tentukan lamanya waktu pencarian, 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 properti ke PageSize default nol.
Tentukan jumlah maksimum entri yang akan dikembalikan, menggunakan SizeLimit properti . Jika Anda mengatur properti ke SizeLimit 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 System.DirectoryServices gambaran umumnya.

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 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 mengatur 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 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 yang 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

Bagikan melalui