DirectoryEntry Třída

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

DirectoryEntry.cs

Třída DirectoryEntry zapouzdřuje uzel nebo objekt v hierarchii Active Directory Domain Services.

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

Dědičnost

Object

MarshalByRefObject

Component

DirectoryEntry

Atributy

TypeConverterAttribute

Poznámky

Tuto třídu použijte pro vazbu na objekty nebo čtení a aktualizaci atributů. DirectoryEntry, spolu s pomocnými třídami, poskytuje podporu pro správu životního cyklu a metody navigace. Patří mezi ně vytvoření, odstranění, přejmenování, přesun podřízeného uzlu a výčet podřízených uzlů. Po úpravě uzlu musíte potvrdit změny, aby se uložily do stromu. Další informace najdete ve CommitChanges vlastnosti.

DirectoryEntry lze použít pro přístup k běžným položkám a některým, ale ne všem, informacím z položek schématu.

Hierarchie Active Directory Domain Services obsahuje až několik tisíc uzlů. Každý uzel představuje objekt, například síťovou tiskárnu nebo uživatele v doméně. Podnikové sítě se neustále mění s tím, jak se najímají noví zaměstnanci a přidávají se objekty, jako jsou síťové tiskárny a počítače. Technologie ADSI (Active Directory Service Interfaces) poskytuje způsoby, jak tyto objekty programově přidat do stromu adresářů.

Pokud chcete vytvořit položku adresáře v hierarchii, použijte Children vlastnost . Vlastnost Children je kolekce, která poskytuje metodu Add , pomocí které přidáte uzel do kolekce přímo pod nadřazený uzel, na který jste aktuálně vázáni. Při přidávání uzlu do kolekce musíte zadat název nového uzlu a název šablony schématu, kterou chcete k uzlu přidružit. Můžete například použít schéma s názvem "Počítač" k přidání nových počítačů do hierarchie.

Tato třída také obsahuje ukládání atributů do mezipaměti, což může být užitečné pro optimalizaci síťového provozu. Pokud chcete použít ukládání atributů do mezipaměti, podívejte se na UsePropertyCache vlastnost .

Třídy přidružené k komponentě DirectoryEntry lze použít u libovolného z poskytovatelů Active Directory Domain Services služeb. Mezi aktuální poskytovatele patří Internetová informační služba (IIS), protokol LDAP (Lightweight Directory Access Protocol), NDS (Novell NetWare Directory Service) a WinNT.

Poznámka

Předpokládá se, že před použitím této třídy máte obecné znalosti Active Directory Domain Services. Další informace najdete v přehledu System.DirectoryServices oboru názvů.

Konstruktory

DirectoryEntry()	Inicializuje novou instanci DirectoryEntry třídy.
DirectoryEntry(Object)	Inicializuje novou instanci DirectoryEntry třídy, která se váže na zadaný nativní Active Directory Domain Services objekt.
DirectoryEntry(String)	Inicializuje novou instanci DirectoryEntry třídy, která vytvoří vazbu této instance k uzlu v Active Directory Domain Services umístěné v zadané cestě.
DirectoryEntry(String, String, String)	Inicializuje novou instanci DirectoryEntry třídy.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicializuje novou instanci DirectoryEntry třídy.

Vlastnosti

AuthenticationType	Získá nebo nastaví typ ověřování, který chcete použít.
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Children	Získá podřízené položky tohoto uzlu v hierarchii Active Directory Domain Services.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Guid	Získá identifikátor GUID objektu DirectoryEntry.
Name	Získá název objektu s názvem základní adresářové služby.
NativeGuid	Získá identifikátor GUID DirectoryEntry, jak je vráceno zprostředkovatele.
NativeObject	Získá nativní rozhraní služby Active Directory Service Interfaces (ADSI) objekt.
ObjectSecurity	Získá nebo nastaví popisovač zabezpečení pro tuto položku.
Options	Získá možnosti specifické pro zprostředkovatele pro tuto položku.
Parent	Získá nadřazenou položku v hierarchii Active Directory Domain Services.
Password	Nastaví heslo, které se má použít při ověřování klienta.
Path	Získá nebo nastaví cestu pro tento DirectoryEntry.
Properties	Získá Active Directory Domain Services vlastnosti pro tento DirectoryEntry objekt.
SchemaClassName	Získá název třídy schématu pro tento DirectoryEntry objekt.
SchemaEntry	Získá objekt schématu pro tuto položku.
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
UsePropertyCache	Získá nebo nastaví hodnotu určující, zda má být mezipaměť potvrzena po každé operaci.
Username	Získá nebo nastaví uživatelské jméno, které se má použít při ověřování klienta.

Metody

Close()	DirectoryEntry Zavře objekt a uvolní všechny systémové prostředky, které jsou přidruženy k této komponentě.
CommitChanges()	Uloží změny provedené v položce adresáře do příslušného úložiště adresářů.
CopyTo(DirectoryEntry)	Vytvoří kopii této položky jako podřízenou položku zadaného nadřazeného objektu.
CopyTo(DirectoryEntry, String)	Vytvoří kopii tohoto DirectoryEntry objektu jako podřízenou položku zadaného nadřazeného DirectoryEntry objektu se zadaným novým názvem.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
DeleteTree()	Odstraní tuto položku a celý její podstrom z hierarchie Active Directory Domain Services.
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Odstraňuje prostředky (jiné než paměť), které používá objekt DirectoryEntry.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Exists(String)	Určuje, zda zadaná cesta představuje skutečnou položku v adresářové službě.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Invoke(String, Object[])	Zavolá metodu nativního objektu Active Directory Domain Services.
InvokeGet(String)	Získá vlastnost z nativního objektu Active Directory Domain Services.
InvokeSet(String, Object[])	Nastaví vlastnost nativního objektu Active Directory Domain Services.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
MoveTo(DirectoryEntry)	Přesune tento DirectoryEntry objekt do zadaného nadřazeného objektu.
MoveTo(DirectoryEntry, String)	Přesune tento DirectoryEntry objekt na zadaný nadřazený objekt a změní jeho název na zadanou hodnotu.
RefreshCache()	Načte hodnoty vlastností pro tento DirectoryEntry objekt do mezipaměti vlastností.
RefreshCache(String[])	Načte hodnoty zadaných vlastností do mezipaměti vlastností.
Rename(String)	Změní název tohoto DirectoryEntry objektu.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)