DirectoryEntry Třída

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Zdroj:

DirectoryEntry.cs

Třída DirectoryEntry zapouzdřuje uzel nebo objekt v hierarchii služby 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ů. DirectoryEntryspolu s pomocnými třídami poskytuje podporu pro správu životního cyklu a navigační metody. Patří mezi ně vytváření, odstraňování, přejmenování, přesouvání podřízeného uzlu a vytváření výčtů podřízených položek. Po úpravě uzlu je nutné potvrdit změny, aby se uložily do stromu. Další informace najdete ve vlastnosti CommitChanges().

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 služby 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ě. Firemní sítě se neustále mění, protože 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 adresářového stromu.

Chcete-li vytvořit položku adresáře v hierarchii, použijte Children vlastnost. Vlastnost Children je kolekce, která poskytuje metodu Add , prostřednictvím které přidáte uzel do kolekce přímo pod nadřazený uzel, ke kterému 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 přidružit k uzlu. Například můžete chtít 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 tuto vlastnost.

Třídy přidružené ke komponentě DirectoryEntry lze použít s libovolnými poskytovateli služeb Active Directory Domain Services. Někteří z aktuálních poskytovatelů jsou Internetová informační služba (IIS), protokol LDAP (Lightweight Directory Access Protocol), Novell NetWare Directory Service (NDS) a WinNT.

Poznámka:

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

Konstruktory

Name	Description
DirectoryEntry()	Inicializuje novou instanci DirectoryEntry třídy.
DirectoryEntry(Object)	Inicializuje novou instanci DirectoryEntry třídy, která je vázána na zadaný nativní objekt služby Active Directory Domain Services.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicializuje novou instanci DirectoryEntry třídy.
DirectoryEntry(String, String, String)	Inicializuje novou instanci DirectoryEntry třídy.
DirectoryEntry(String)	Inicializuje novou instanci třídy, která vytvoří vazbu této instance DirectoryEntry na uzel ve službě Active Directory Domain Services umístěné v zadané cestě.

Vlastnosti

Name	Description
AuthenticationType	Získá nebo nastaví typ ověřování, který se má použít.
Children	Získá podřízené položky tohoto uzlu v hierarchii služby Active Directory Domain Services.
Guid	Získá identifikátor GUID DirectoryEntry.
Name	Získá název objektu tak, jak má název s podkladovou adresářovou službou.
NativeGuid	Získá identifikátor GUID identifikátoru DirectoryEntry, jak je vráceno od zprostředkovatele.
NativeObject	Získá nativní objekt ROZHRANÍ služby Active Directory (ADSI).
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řazený objekt této položky v hierarchii služby 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á vlastnosti služby Active Directory Domain Services 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.
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

Name	Description
Close()	DirectoryEntry Zavře objekt a uvolní všechny systémové prostředky, které jsou přidružené k této komponentě.
CommitChanges()	Uloží změny provedené v položce adresáře do základního úložiště adresářů.
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.
CopyTo(DirectoryEntry)	Vytvoří kopii této položky jako podřízenou položku zadané nadřazené položky.
DeleteTree()	Odstraní tuto položku a její celý podstrom z hierarchie služby Active Directory Domain Services.
Dispose(Boolean)	Odstraní prostředky (jiné než paměť), které jsou používány DirectoryEntry.
Exists(String)	Určuje, zda zadaná cesta představuje skutečnou položku v adresářové službě.
Invoke(String, Object[])	Volá metodu nativního objektu služby Active Directory Domain Services.
InvokeGet(String)	Získá vlastnost z nativního objektu služby Active Directory Domain Services.
InvokeSet(String, Object[])	Nastaví vlastnost nativního objektu služby Active Directory Domain Services.
MoveTo(DirectoryEntry, String)	Přesune tento DirectoryEntry objekt do zadaného nadřazeného objektu a změní jeho název na zadanou hodnotu.
MoveTo(DirectoryEntry)	Přesune tento DirectoryEntry objekt do zadaného nadřazeného objektu.
RefreshCache()	Načte hodnoty vlastností tohoto DirectoryEntry objektu 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.