DirectoryEntry Klasa

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

Pakiet:

System.DirectoryServices v8.0.0

Źródło:

DirectoryEntry.cs

Klasa DirectoryEntry hermetyzuje węzeł lub obiekt w 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

Dziedziczenie

Object

MarshalByRefObject

Component

DirectoryEntry

Atrybuty

TypeConverterAttribute

Uwagi

Ta klasa służy do wiązania z obiektami lub odczytywania i aktualizowania atrybutów. DirectoryEntry, wraz z klasami pomocniczymi, zapewnia obsługę metod zarządzania cyklem życia i nawigacji. Obejmują one tworzenie, usuwanie, zmienianie nazw, przenoszenie węzła podrzędnego i wyliczanie elementów podrzędnych. Po zmodyfikowaniu węzła należy zatwierdzić zmiany, aby zostały zapisane w drzewie. Aby uzyskać więcej informacji, zobacz CommitChanges właściwość .

DirectoryEntry może służyć do uzyskiwania dostępu do zwykłych wpisów i niektórych, ale nie wszystkich informacji z wpisów schematu.

Hierarchia Active Directory Domain Services zawiera maksymalnie kilka tysięcy węzłów. Każdy węzeł reprezentuje obiekt, taki jak drukarka sieciowa lub użytkownik w domenie. Sieci firmowe stale zmieniają się, ponieważ nowi pracownicy są zatrudniani i dodawane są obiekty, takie jak drukarki sieciowe i komputery. Technologia interfejsów usługi Active Directory (ADSI) udostępnia sposoby programowego dodawania tych obiektów do drzewa katalogów.

Aby utworzyć wpis katalogu w hierarchii, użyj Children właściwości . Właściwość Children jest kolekcją, która udostępnia metodę Add , za pomocą której dodasz węzeł do kolekcji bezpośrednio poniżej węzła nadrzędnego, z którym obecnie jest powiązana. Podczas dodawania węzła do kolekcji należy określić nazwę nowego węzła oraz nazwę szablonu schematu, który chcesz skojarzyć z węzłem. Na przykład możesz użyć schematu zatytułowanego "Komputer", aby dodać nowe komputery do hierarchii.

Ta klasa zawiera również buforowanie atrybutów, co może być przydatne do optymalizacji ruchu sieciowego. Aby użyć buforowania atrybutów, zobacz UsePropertyCache właściwość .

Klasy skojarzone z składnikiem DirectoryEntry mogą być używane z dowolnymi dostawcami usług Active Directory Domain Services. Niektórzy z bieżących dostawców to Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) i WinNT.

Uwaga

Przyjęto założenie, że masz ogólną wiedzę na temat Active Directory Domain Services przed użyciem tej klasy. Aby uzyskać więcej informacji, zobacz System.DirectoryServices omówienie przestrzeni nazw.

Konstruktory

DirectoryEntry()	Inicjuje nowe wystąpienie klasy DirectoryEntry.
DirectoryEntry(Object)	Inicjuje DirectoryEntry nowe wystąpienie klasy, która wiąże się z określonym natywnym obiektem Active Directory Domain Services.
DirectoryEntry(String)	Inicjuje DirectoryEntry nowe wystąpienie klasy, która wiąże to wystąpienie z węzłem w Active Directory Domain Services znajdującym się w określonej ścieżce.
DirectoryEntry(String, String, String)	Inicjuje nowe wystąpienie klasy DirectoryEntry.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicjuje nowe wystąpienie klasy DirectoryEntry.

Właściwości

AuthenticationType	Pobiera lub ustawia typ uwierzytelniania do użycia.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Children	Pobiera wpisy podrzędne tego węzła w hierarchii Active Directory Domain Services.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
Guid	Pobiera identyfikator GUID obiektu DirectoryEntry.
Name	Pobiera nazwę obiektu o nazwie z bazową usługą katalogową.
NativeGuid	Pobiera identyfikator GUID elementu DirectoryEntry, który jest zwracany z dostawcy.
NativeObject	Pobiera natywny obiekt interfejsów usługi Active Directory (ADSI).
ObjectSecurity	Pobiera lub ustawia deskryptor zabezpieczeń dla tego wpisu.
Options	Pobiera opcje specyficzne dla dostawcy dla tego wpisu.
Parent	Pobiera element nadrzędny tego wpisu w hierarchii Active Directory Domain Services.
Password	Ustawia hasło do użycia podczas uwierzytelniania klienta.
Path	Pobiera lub ustawia ścieżkę dla tego elementu DirectoryEntry.
Properties	Pobiera właściwości Active Directory Domain Services dla tego DirectoryEntry obiektu.
SchemaClassName	Pobiera nazwę klasy schematu dla tego DirectoryEntry obiektu.
SchemaEntry	Pobiera obiekt schematu dla tego wpisu.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
UsePropertyCache	Pobiera lub ustawia wartość wskazującą, czy pamięć podręczna powinna zostać zatwierdzona po każdej operacji.
Username	Pobiera lub ustawia nazwę użytkownika do użycia podczas uwierzytelniania klienta.

Metody

Close()	DirectoryEntry Zamyka obiekt i zwalnia wszystkie zasoby systemowe skojarzone z tym składnikiem.
CommitChanges()	Zapisuje zmiany wprowadzone w wpisie katalogu do bazowego magazynu katalogów.
CopyTo(DirectoryEntry)	Tworzy kopię tego wpisu jako element podrzędny określonego elementu nadrzędnego.
CopyTo(DirectoryEntry, String)	Tworzy kopię tego DirectoryEntry obiektu jako element podrzędny określonego obiektu nadrzędnego DirectoryEntry o określonej nazwie.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
DeleteTree()	Usuwa ten wpis i całe poddrzewo z hierarchii Active Directory Domain Services.
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Usuwa zasoby (inne niż pamięć), które są używane przez DirectoryEntryprogram .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Exists(String)	Określa, czy określona ścieżka reprezentuje rzeczywisty wpis w usłudze katalogowej.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Invoke(String, Object[])	Wywołuje metodę obiektu natywnego Active Directory Domain Services.
InvokeGet(String)	Pobiera właściwość z natywnego obiektu Active Directory Domain Services.
InvokeSet(String, Object[])	Ustawia właściwość obiektu natywnego Active Directory Domain Services.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MoveTo(DirectoryEntry)	Przenosi ten DirectoryEntry obiekt do określonego elementu nadrzędnego.
MoveTo(DirectoryEntry, String)	Przenosi ten DirectoryEntry obiekt do określonego elementu nadrzędnego i zmienia jego nazwę na określoną wartość.
RefreshCache()	Ładuje wartości właściwości dla tego DirectoryEntry obiektu do pamięci podręcznej właściwości.
RefreshCache(String[])	Ładuje wartości określonych właściwości do pamięci podręcznej właściwości.
Rename(String)	Zmienia nazwę tego DirectoryEntry obiektu.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)