DirectoryEntry Osztály

Definíció

Névtér:

System.DirectoryServices

Szerelvény:

System.DirectoryServices.dll

Csomag:

System.DirectoryServices v11.0.0-rc.1.26425.128

Forrás:

DirectoryEntry.cs

A DirectoryEntry osztály beágyaz egy csomópontot vagy objektumot a Active Directory tartományi szolgáltatások hierarchiába.

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

Öröklődés

Object

MarshalByRefObject

Component

DirectoryEntry

Attribútumok

TypeConverterAttribute

Megjegyzések

Ez az osztály az objektumokhoz való kötéshez, illetve az attribútumok olvasásához és frissítéséhez használható. DirectoryEntrysegédosztályokkal együtt támogatja az életciklus-kezelési és a navigációs módszereket. Ilyen például a gyermekcsomópont létrehozása, törlése, átnevezése, áthelyezése és a gyermekek számbavétele. A csomópont módosítása után véglegesítenie kell a módosításokat ahhoz, hogy azok a fára legyenek mentve. További információért lásd a CommitChanges() tulajdonságot.

DirectoryEntry A sémabejegyzésekből származó rendszeres bejegyzésekhez és néhány, de nem az összes információhoz való hozzáféréshez használható.

A Active Directory tartományi szolgáltatások hierarchia legfeljebb több ezer csomópontot tartalmaz. Minden csomópont egy objektumot jelöl, például egy hálózati nyomtatót vagy egy tartomány felhasználóját. A vállalati hálózatok folyamatosan változnak, ahogy új alkalmazottakat alkalmaznak, és olyan objektumokat adnak hozzá, mint a hálózati nyomtatók és a számítógépek. Active Directory Service Interfaces (ADSI) technológia lehetővé teszi az objektumok programozott hozzáadását a címtárfához.

Ha címtárbejegyzést szeretne létrehozni a hierarchiában, használja a tulajdonságot Children . A Children tulajdonság egy metódust Add biztosító gyűjtemény, amelyen keresztül közvetlenül a szülőcsomópont alatt adhat hozzá csomópontot a gyűjteményhez. Amikor csomópontot ad hozzá a gyűjteményhez, meg kell adnia az új csomópont nevét és a csomóponthoz társítani kívánt sémasablon nevét. Előfordulhat például, hogy a "Számítógép" nevű sémával szeretne új számítógépeket hozzáadni a hierarchiához.

Ez az osztály attribútum-gyorsítótárazást is tartalmaz, amely hasznos lehet a hálózati forgalom optimalizálásához. Az attribútumok gyorsítótárazásának használatához tekintse meg a tulajdonságot UsePropertyCache .

A DirectoryEntry összetevőhöz társított osztályok bármelyik Active Directory tartományi szolgáltatások szolgáltatónál használhatók. Néhány jelenlegi szolgáltató a Internet Information Services (IIS), az Lightweight Directory Access Protocol (LDAP), a Novell NetWare Directory Service (NDS) és a WinNT.

Note

Feltételezzük, hogy az osztály használata előtt általános ismeretekkel rendelkezik a Active Directory tartományi szolgáltatások. További információkért tekintse meg a System.DirectoryServices névtér áttekintését.

Konstruktorok

Name	Description
DirectoryEntry()	Inicializálja a DirectoryEntry osztály új példányát.
DirectoryEntry(Object)	Inicializálja a megadott natív Active Directory tartományi szolgáltatások objektumhoz kötődő DirectoryEntry osztály új példányát.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicializálja a DirectoryEntry osztály új példányát.
DirectoryEntry(String, String, String)	Inicializálja a DirectoryEntry osztály új példányát.
DirectoryEntry(String)	Inicializálja a DirectoryEntry osztály új példányát, amely ezt a példányt a megadott útvonalon található Active Directory tartományi szolgáltatások csomóponthoz köti.

Tulajdonságok

Name	Description
AuthenticationType	Lekéri vagy beállítja a használni kívánt hitelesítés típusát.
Children	Lekéri a csomópont gyermekbejegyzéseit a Active Directory tartományi szolgáltatások hierarchiában.
Guid	Lekéri a GUID azonosítóját.DirectoryEntry
Name	Lekéri az objektum nevét a mögöttes címtárszolgáltatás neveként.
NativeGuid	Lekéri a DirectoryEntryszolgáltatótól visszaadott GUID azonosítót.
NativeObject	Lekéri a natív Active Directory Service Interfaces (ADSI) objektumot.
ObjectSecurity	Lekéri vagy beállítja a bejegyzéshez tartozó biztonsági leírót.
Options	Lekéri a bejegyzés szolgáltatóspecifikus beállításait.
Parent	Lekéri a bejegyzés szülőjét a Active Directory tartományi szolgáltatások hierarchiában.
Password	Beállítja az ügyfél hitelesítésekor használni kívánt jelszót.
Path	Lekéri vagy beállítja ennek DirectoryEntryaz elérési útját.
Properties	Lekéri a DirectoryEntry objektum Active Directory tartományi szolgáltatások tulajdonságait.
SchemaClassName	Lekéri az objektum sémaosztályának DirectoryEntry nevét.
SchemaEntry	Lekéri a bejegyzés sémaobjektumát.
UsePropertyCache	Lekéri vagy beállít egy értéket, amely jelzi, hogy a gyorsítótárat minden művelet után le kell-e véglegesíteni.
Username	Lekéri vagy beállítja az ügyfél hitelesítésekor használni kívánt felhasználónevet.

Metódusok

Name	Description
Close()	Bezárja az DirectoryEntry objektumot, és felszabadítja az összetevőhöz társított rendszererőforrásokat.
CommitChanges()	Menti a könyvtárbejegyzés módosításait a mögöttes címtártárolóba.
CopyTo(DirectoryEntry, String)	Létrehozza az DirectoryEntry objektum másolatát a megadott szülőobjektum DirectoryEntry gyermekeként, a megadott új névvel.
CopyTo(DirectoryEntry)	A bejegyzés másolatát a megadott szülő gyermekeként hozza létre.
DeleteTree()	Törli ezt a bejegyzést és annak teljes részhalmazát a Active Directory tartományi szolgáltatások hierarchiából.
Dispose(Boolean)	A a rendszer által használt erőforrásokat (a memória kivételével) megsemmisíti DirectoryEntry.
Exists(String)	Meghatározza, hogy a megadott elérési út egy tényleges bejegyzést jelöl-e a címtárszolgáltatásban.
Invoke(String, Object[])	Metódus meghívása a natív Active Directory tartományi szolgáltatások objektumon.
InvokeGet(String)	Tulajdonságot kap a natív Active Directory tartományi szolgáltatások objektumtól.
InvokeSet(String, Object[])	Beállít egy tulajdonságot a natív Active Directory tartományi szolgáltatások objektumon.
MoveTo(DirectoryEntry, String)	Áthelyezi ezt az DirectoryEntry objektumot a megadott szülőre, és a nevét a megadott értékre módosítja.
MoveTo(DirectoryEntry)	DirectoryEntry Az objektum áthelyezése a megadott szülőre.
RefreshCache()	Betölti az objektum tulajdonságértékét DirectoryEntry a tulajdonsággyorsítótárba.
RefreshCache(String[])	Betölti a megadott tulajdonságok értékeit a tulajdonság-gyorsítótárba.
Rename(String)	Módosítja DirectoryEntry az objektum nevét.