DirectoryEntry Sınıf

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Kaynak:

DirectoryEntry.cs

sınıfı, DirectoryEntry Active Directory Etki Alanı Hizmetleri 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ğlanmak veya öznitelikleri okumak ve güncelleştirmek 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, alt düğüm taşıma ve alt öğeleri listeleme yer alır. Bir düğümü değiştirdikten sonra, değişikliklerinizin ağaca kaydedilmesi için değişikliklerinizi işlemeniz gerekir. Daha fazla bilgi için CommitChanges() özelliğine bakın.

DirectoryEntry normal girdilere erişmek için kullanılabilir ve şema girişlerinden bazı bilgilere ancak tümüne erişemez.

Active Directory Etki Alanı Hizmetleri 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 Etki Alanı Hizmetleri 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.

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 ad alanına genel bakış bölümüne System.DirectoryServices bakın.

Oluşturucular

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

Özellikler

Name	Description
AuthenticationType	Kullanılacak kimlik doğrulama türünü alır veya ayarlar.
Children	Active Directory Etki Alanı Hizmetleri hiyerarşisinde bu düğümün alt girdilerini alır.
Guid	GUID değerini DirectoryEntryalır.
Name	Temel dizin hizmetiyle 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 girdi 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 Etki Alanı Hizmetleri 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 Etki Alanı Hizmetleri özelliklerini alır.
SchemaClassName	Bu DirectoryEntry nesne için şema sınıfının adını alır.
SchemaEntry	Bu girdi için şema nesnesini alır.
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

Name	Description
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, String)	Bu DirectoryEntry nesnenin, belirtilen üst DirectoryEntry nesnenin alt öğesi olarak, belirtilen yeni ada sahip bir kopyasını oluşturur.
CopyTo(DirectoryEntry)	Bu girdinin bir kopyasını belirtilen üst öğesinin alt öğesi olarak oluşturur.
DeleteTree()	Bu girdiyi ve alt ağacının tamamını Active Directory Etki Alanı Hizmetleri hiyerarşisinden siler.
Dispose(Boolean)	tarafından kullanılan kaynakları (bellek dışında) atılır DirectoryEntry.
Exists(String)	Belirtilen yolun dizin hizmetindeki gerçek bir girdiyi temsil ediyor olup olmadığını belirler.
Invoke(String, Object[])	Yerel Active Directory Etki Alanı Hizmetleri nesnesinde bir yöntem çağırır.
InvokeGet(String)	Yerel Active Directory Etki Alanı Hizmetleri nesnesinden bir özellik alır.
InvokeSet(String, Object[])	Yerel Active Directory Etki Alanı Hizmetleri nesnesinde bir özellik ayarlar.
MoveTo(DirectoryEntry, String)	Bu DirectoryEntry nesneyi belirtilen üst öğeye taşır ve adını belirtilen değerle değiştirir.
MoveTo(DirectoryEntry)	Bu DirectoryEntry nesneyi belirtilen üst öğeye taşır.
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.