DirectorySearcher Sınıf

Tanım

Active Directory Etki Alanı Hizmetleri'ne karşı sorgular gerçekleştirir.

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
Devralma
DirectorySearcher
Öznitelikler

Açıklamalar

Basit Dizin Erişim Protokolü (LDAP) kullanarak bir Active Directory Etki Alanı Hizmetleri hiyerarşisinde arama yapmak ve bu hiyerarşide sorgular gerçekleştirmek için bir DirectorySearcher nesne kullanın. LDAP, dizin aramayı destekleyen sistem tarafından sağlanan tek Active Directory Hizmet Arabirimleri (ADSI) sağlayıcısıdır. Bir yönetici hiyerarşide bulunan nesneleri yapabilir, değiştirebilir ve silebilir. Daha fazla bilgi için bkz. System.DirectoryServices kullanma.

örneğini DirectorySearcheroluşturduğunuzda, almak istediğiniz kökü ve alınacak isteğe bağlı özelliklerin listesini belirtirsiniz. özelliği, SearchRoot aşağıdaki görevleri gerçekleştirmek için ek özellikler ayarlamanıza olanak tanır:

  • Arama sonuçlarını yerel bilgisayarda önbelleğe alın. CacheResults Dizin bilgilerini yerel bilgisayarda depolamak true için özelliğini olarak ayarlayın. Güncelleştirmeler bu yerel önbellekte yapılır ve yalnızca yöntem çağrıldığında Active Directory Etki Alanı Hizmetleri'ne DirectoryEntry.CommitChanges işlenir.

  • özelliğini kullanarak ServerTimeLimit arama süresini belirtin.

  • Yalnızca öznitelik adlarını alın. yalnızca değerlerin PropertyNamesOnly atandığı özniteliklerin adlarını almak için özelliğini true olarak ayarlayın.

  • Sayfalanmış arama yapma. PageSize Özelliğini, sayfalanmış aramada döndürülen en fazla nesne sayısını belirtecek şekilde ayarlayın. Sayfalanmış arama yapmak istemiyorsanız, özelliği varsayılan sıfır olarak ayarlayın PageSize .

  • özelliğini kullanarak SizeLimit döndürülecek en fazla girdi sayısını belirtin. Özelliği varsayılan olarak sıfır olarak ayarlarsanız SizeLimit , sunucu tarafından belirlenen varsayılan değer 1000 giriştir.

Not

Döndürülen girdi sayısı üst sınırı ve süre sınırları sunucuda ayarlanan sınırlamaları aşarsa, sunucu ayarları bileşen ayarlarını geçersiz kılar.

Sınıfının bir örneğinin ilk özellik değerlerinin DirectorySearcher listesi için oluşturucuya DirectorySearcher() bakın.

Not

Bu sınıfı kullanmadan önce Active Directory Etki Alanı Hizmetleri hakkında genel bir anlayışa sahip olduğunuz varsayılır. Daha fazla bilgi için bkz System.DirectoryServices . genel bakış.

Oluşturucular

DirectorySearcher()

DirectorySearcher sınıfının yeni bir örneğini varsayılan değerlerle başlatır.

DirectorySearcher(DirectoryEntry)

Belirtilen arama kökünü kullanarak sınıfın DirectorySearcher yeni bir örneğini başlatır.

DirectorySearcher(DirectoryEntry, String)

Belirtilen arama kökü ve arama filtresiyle sınıfının yeni bir örneğini DirectorySearcher başlatır.

DirectorySearcher(DirectoryEntry, String, String[])

Sınıfın DirectorySearcher yeni bir örneğini, alınacak belirtilen arama kökü, arama filtresi ve özelliklerle başlatır.

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

Belirtilen arama kökü, arama filtresi, alınacak özellikler ve arama kapsamı ile sınıfının yeni bir örneğini DirectorySearcher başlatır.

DirectorySearcher(String)

Belirtilen arama filtresiyle sınıfının yeni bir örneğini DirectorySearcher başlatır.

DirectorySearcher(String, String[])

Sınıfın DirectorySearcher yeni bir örneğini, alınacak belirtilen arama filtresi ve özellikleriyle başlatır.

DirectorySearcher(String, String[], SearchScope)

Belirtilen arama filtresi, alınacak özellikler ve arama kapsamı ile sınıfının yeni bir örneğini DirectorySearcher başlatır.

Özellikler

Asynchronous

Aramanın zaman uyumsuz olarak gerçekleştirilip gerçekleştirilmediğini belirten bir değer alır veya ayarlar.

AttributeScopeQuery

Aranacak ayırt edici ad özniteliğinin LDAP görünen adını alır veya ayarlar. Bu arama türü için yalnızca bir öznitelik kullanılabilir.

CacheResults

Sonucun istemci bilgisayarda önbelleğe alınıp alınmadığını belirten bir değer alır veya ayarlar.

CanRaiseEvents

Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır.

(Devralındığı yer: Component)
ClientTimeout

İstemcinin sunucunun sonuç döndürmesini bekleyeceği en uzun süreyi alır veya ayarlar. Sunucu bu süre içinde yanıt vermezse arama durduruldu ve sonuç döndürülmedi.

Container

öğesini IContainer içeren öğesini Componentalır.

(Devralındığı yer: Component)
DerefAlias

Arama sırasında bulunan nesnelerin diğer adlarının nasıl çözümlenmesi gerektiğini belirten bir değer alır veya ayarlar.

DesignMode

öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır.

(Devralındığı yer: Component)
DirectorySynchronization

Arama ile kullanılacak dizin eşitleme denetimini temsil eden bir nesneyi alır veya ayarlar.

Events

Bu Componentöğesine eklenen olay işleyicilerinin listesini alır.

(Devralındığı yer: Component)
ExtendedDN

Ayırt edici adların biçimini gösteren bir değer alır veya ayarlar.

Filter

Basit Dizin Erişim Protokolü (LDAP) biçimli filtre dizesini belirten bir değer alır veya ayarlar.

PageSize

Sayfalanmış aramada sayfa boyutunu belirten bir değer alır veya ayarlar.

PropertiesToLoad

Arama sırasında alınacak özelliklerin listesini gösteren bir değer alır.

PropertyNamesOnly

Aramanın yalnızca değerlerin atandığı özniteliklerin adlarını alıp almadığını belirten bir değer alır veya ayarlar.

ReferralChasing

Referansların nasıl kovalandığını gösteren bir değer alır veya ayarlar.

SearchRoot

Aramanın başladığı Active Directory Etki Alanı Hizmetleri hiyerarşisindeki düğümü belirten bir değer alır veya ayarlar.

SearchScope

Sunucu tarafından gözlemlenen aramanın kapsamını belirten bir değer alır veya ayarlar.

SecurityMasks

Belirtilen öznitelikler için hangi güvenlik erişim bilgilerinin arama tarafından döndürülmesi gerektiğini belirten bir değer alır veya ayarlar.

ServerPageTimeLimit

Sunucunun tek bir sonuç sayfası için arama yapması gereken en uzun süreyi belirten bir değer alır veya ayarlar. Bu, aramanın tamamı için süre sınırıyla aynı değildir.

ServerTimeLimit

özelliği, ServerTimeLimit sunucunun arama için harcadığı en uzun süreyi belirten bir değer alır veya ayarlar. Süre sınırına ulaşılırsa, yalnızca bu noktaya kadar bulunan girişler döndürülür.

Site

öğesini alır veya ayarlar ISiteComponent.

(Devralındığı yer: Component)
SizeLimit

Sunucunun aramada döndürdüğü en fazla nesne sayısını belirten bir değer alır veya ayarlar.

Sort

Sonuçların sıralandığı özelliği belirten bir değeri alır veya ayarlar.

Tombstone

Aramanın arama filtresiyle eşleşen silinmiş nesneleri de döndürmesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.

VirtualListView

Arama için sanal liste görünümü seçeneklerini gösteren bir değer alır veya ayarlar.

Yöntemler

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

Nesnesi tarafından DirectorySearcher kullanılan yönetilen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilmeyen kaynakları serbest bırakır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindAll()

Aramayı yürütür ve bulunan girdilerden oluşan bir koleksiyon döndürür.

FindOne()

Aramayı yürütür ve yalnızca bulunan ilk girişi döndürür.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetService(Type)

veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
ToString()

Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.