DirectorySearcher Sınıf

Tanım

Ad Alanı:: System.DirectoryServices

Bütünleştirilmiş Kod:: System.DirectoryServices.dll

Paket:: System.DirectoryServices v11.0.0-preview.2.26159.112

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Kaynak:: DirectorySearcher.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Active Directory Etki Alanı Hizmetleri'ne yönelik 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: Object

MarshalByRefObject

Component
DirectorySearcher

Öznitelikler: DSDescriptionAttribute

Açıklamalar

DirectorySearcher Basit Dizin Erişim Protokolü (LDAP) kullanarak Active Directory Etki Alanı Hizmetleri hiyerarşisinde arama yapmak ve bu hiyerarşide sorgular gerçekleştirmek için bir nesne kullanın. LDAP, dizin aramayı destekleyen tek sistem tarafından sağlanan 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 Yerel bilgisayarda dizin bilgilerini depolamak true için özelliğini olarak ayarlayın. Güncelleştirmeler bu yerel önbellekte yapılır ve yalnızca yöntemi çağrıldığında Active Directory Etki Alanı Hizmetleri'ne DirectoryEntry.CommitChanges işlenir.
özelliğini kullanarak ServerTimeLimit aranacak süreyi belirtin.
Yalnızca öznitelik adlarını alın. PropertyNamesOnly özelliğini, true yalnızca değerlerin atandığı özniteliklerin adlarını alacak şekilde ayarlayın.
Sayfalanmış arama gerçekleştirme. Özelliği, PageSize sayfalanmış aramada döndürülen en fazla nesne sayısını belirtmek için ayarlayın. Disk belleğine alınmış 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 sıfır olarak ayarlarsanız SizeLimit , sunucu tarafından belirlenen varsayılan değer 1000 giriştir.

Uyarı

Döndürülen girdi sayısı ve süre sınırları üst sınırı 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.

Uyarı

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 genel bakışa System.DirectoryServices bakın.

Oluşturucular

Name	Description
DirectorySearcher()	Sınıfın DirectorySearcher yeni bir örneğini varsayılan değerlerle 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 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)	Belirtilen arama kökü ve arama filtresiyle sınıfın yeni bir örneğini DirectorySearcher başlatır.
DirectorySearcher(DirectoryEntry)	Belirtilen arama kökünü kullanarak sınıfın DirectorySearcher yeni bir örneğini başlatır.
DirectorySearcher(String, String[], SearchScope)	Belirtilen arama filtresi, alınacak özellikler ve arama kapsamı ile sınıfı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)	Belirtilen arama filtresiyle sınıfının yeni bir örneğini DirectorySearcher başlatır.

Özellikler

Name	Description
Asynchronous	Aramanın zaman uyumsuz olarak gerçekleştirilip gerçekleştirilmediğini gösteren 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 tür arama 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	Aramayla 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 gösteren bir değer alır veya ayarlar.
PageSize	Sayfalanmış aramada sayfa boyutunu gösteren 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 izlendiğini 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ığı maksimum 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 ISite Component. (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 gösteren bir değer 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

Name	Description
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()	tarafından Componentkullanı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 girdilerin bir koleksiyonunu 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 Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type 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 Objectbasit 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ı Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Name	Description
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?