DirectoryEntry Sınıf

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Kaynak:

DirectoryEntry.cs

sınıfı, DirectoryEntry Active Directory Domain Services hiyerarşisindeki bir düğümü veya nesneyi kapsüller.

public ref class DirectoryEntry : System::ComponentModel::Component

[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component

[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

Devralma

Object

MarshalByRefObject

Component

DirectoryEntry

Öznitelikler

TypeConverterAttribute

Açıklamalar

Nesnelere bağlama veya öznitelikleri okuma ve güncelleştirme için bu sınıfı kullanın. DirectoryEntry, yardımcı sınıflarla birlikte yaşam döngüsü yönetimi ve gezinti yöntemleri için destek sağlar. Bunlar arasında alt düğüm oluşturma, silme, yeniden adlandırma, taşıma ve alt öğeleri listeleme sayılabilir. Bir düğümü değiştirdikten sonra, değişikliklerinizin ağaçta kaydedilmesi için değişikliklerinizi işlemeniz gerekir. Daha fazla bilgi için özelliğine CommitChanges bakın.

DirectoryEntry normal girişlere ve şema girişlerinden bazı bilgilere erişmek için kullanılabilir ancak tümüne değil.

Active Directory Domain Services hiyerarşisi en fazla birkaç bin düğüm içerir. Her düğüm, ağ yazıcısı veya etki alanındaki bir kullanıcı gibi bir nesneyi temsil eder. Yeni çalışanlar işe alındıkçe ve ağ yazıcıları ve bilgisayarlar gibi nesneler eklendikçe kurumsal ağlar sürekli değişir. Active Directory Hizmet Arabirimleri (ADSI) teknolojisi, bu nesneleri dizin ağacına program aracılığıyla eklemenin yollarını sağlar.

Hiyerarşide dizin girdisi oluşturmak için özelliğini kullanın Children . Children özelliği, şu anda bağlı olduğunuz üst düğümün hemen altındaki koleksiyona bir düğüm eklediğiniz bir yöntem sağlayan Add bir koleksiyondur. Koleksiyona düğüm eklerken, yeni düğüm için bir ad ve düğümle ilişkilendirmek istediğiniz şema şablonunun adını belirtmeniz gerekir. Örneğin, hiyerarşiye yeni bilgisayarlar eklemek için "Bilgisayar" başlıklı bir şema kullanmak isteyebilirsiniz.

Bu sınıf, ağ trafiğini iyileştirmek için yararlı olabilecek öznitelik önbelleğe alma özelliği de içerir. Öznitelik önbelleğe alma özelliğini kullanmak için özelliğine UsePropertyCache bakın.

Bileşenle DirectoryEntry ilişkili sınıflar Active Directory Domain Services hizmet sağlayıcılarından herhangi biriyle kullanılabilir. Geçerli sağlayıcılardan bazıları Internet Information Services (IIS), Basit Dizin Erişim Protokolü (LDAP), Novell NetWare Dizin Hizmeti (NDS) ve WinNT'dir.

Not

Bu sınıfı kullanmadan önce Active Directory Domain Services hakkında genel bir anlayışa sahip olduğunuz varsayılır. Daha fazla bilgi için ad alanına genel bakış bölümüne System.DirectoryServices bakın.

Oluşturucular

DirectoryEntry()	DirectoryEntry sınıfının yeni bir örneğini başlatır.
DirectoryEntry(Object)	Belirtilen yerel Active Directory Domain Services nesnesine bağlanan sınıfının yeni bir örneğini DirectoryEntry başlatır.
DirectoryEntry(String)	Bu örneği belirtilen yolda bulunan Active Directory Domain Services düğüme bağlayan sınıfının yeni bir örneğini DirectoryEntry başlatır.
DirectoryEntry(String, String, String)	DirectoryEntry sınıfının yeni bir örneğini başlatır.
DirectoryEntry(String, String, String, AuthenticationTypes)	DirectoryEntry sınıfının yeni bir örneğini başlatır.

Özellikler

AuthenticationType	Kullanılacak kimlik doğrulama türünü alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Children	Bu düğümün alt girdilerini Active Directory Domain Services hiyerarşisinde alır.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Guid	guid değerini DirectoryEntryalır.
Name	Temel dizin hizmetiyle birlikte adlı nesnenin adını alır.
NativeGuid	Sağlayıcıdan döndürülen guid DirectoryEntrydeğerini alır.
NativeObject	Yerel Active Directory Hizmet Arabirimleri (ADSI) nesnesini alır.
ObjectSecurity	Bu giriş için güvenlik tanımlayıcısını alır veya ayarlar.
Options	Bu giriş için sağlayıcıya özgü seçenekleri alır.
Parent	Bu girdinin üst öğesini Active Directory Domain Services hiyerarşisinde alır.
Password	İstemcinin kimliğini doğrularken kullanılacak parolayı ayarlar.
Path	Bu DirectoryEntryiçin yolu alır veya ayarlar.
Properties	Bu DirectoryEntry nesnenin Active Directory Domain Services özelliklerini alır.
SchemaClassName	Bu DirectoryEntry nesne için şema sınıfının adını alır.
SchemaEntry	Bu girdinin şema nesnesini alır.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
UsePropertyCache	Önbelleğin her işlemden sonra işlenip işlenmeyeceğini belirten bir değer alır veya ayarlar.
Username	İstemcinin kimliğini doğrularken kullanılacak kullanıcı adını alır veya ayarlar.

Yöntemler

Close()	DirectoryEntry nesnesini kapatır ve bu bileşenle ilişkili tüm sistem kaynaklarını serbest bırakır.
CommitChanges()	Temel alınan dizin deposuna bir dizin girişinde yapılan değişiklikleri kaydeder.
CopyTo(DirectoryEntry)	Bu girdinin bir kopyasını belirtilen üst öğesinin alt öğesi olarak oluşturur.
CopyTo(DirectoryEntry, String)	Bu DirectoryEntry nesnenin, belirtilen üst DirectoryEntry nesnenin alt öğesi olarak, belirtilen yeni ada sahip bir kopyasını oluşturur.
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)
DeleteTree()	Bu girdiyi ve alt ağacının tamamını Active Directory Domain Services hiyerarşisinden siler.
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından kullanılan kaynakları (bellek dışında) atılır DirectoryEntry.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Exists(String)	Belirtilen yolun dizin hizmetindeki gerçek bir girdiyi temsil ediyor olup olmadığını belirler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	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()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Invoke(String, Object[])	Yerel Active Directory Domain Services nesnesinde bir yöntemi çağırır.
InvokeGet(String)	Yerel Active Directory Domain Services nesnesinden bir özellik alır.
InvokeSet(String, Object[])	Yerel Active Directory Domain Services nesnesinde bir özellik ayarlar.
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)
MoveTo(DirectoryEntry)	Bu DirectoryEntry nesneyi belirtilen üst öğeye taşır.
MoveTo(DirectoryEntry, String)	Bu DirectoryEntry nesneyi belirtilen üst öğeye taşır ve adını belirtilen değerle değiştirir.
RefreshCache()	Bu DirectoryEntry nesnenin özellik değerlerini özellik önbelleğine yükler.
RefreshCache(String[])	Belirtilen özelliklerin değerlerini özellik önbelleğine yükler.
Rename(String)	Bu DirectoryEntry nesnenin adını değiştirir.
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)