Udostępnij za pośrednictwem


DirectoryEntry Klasa

Definicja

Klasa DirectoryEntry hermetyzuje węzeł lub obiekt w hierarchii Active Directory Domain Services.

public ref class DirectoryEntry : System::ComponentModel::Component
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Dziedziczenie
Atrybuty

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()
Przestarzałe.

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()
Przestarzałe.

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)

Dotyczy