DirectoryEntry Klasa

Definicja

Klasa DirectoryEntry hermetyzuje węzeł lub obiekt w hierarchii Active Directory Domain Services.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

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
Public Class DirectoryEntry
Inherits Component
Dziedziczenie
Atrybuty

Uwagi

Ta klasa służy do tworzenia powiązań z obiektami lub odczytywania i aktualizowania atrybutów.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, wraz z klasami pomocników, zapewnia pomoc techniczną w zakresie zarządzania cyklem życia i metod nawigacji.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Obejmują one tworzenie, usuwanie, zmienianie nazwy, przeniesienie węzła podrzędnego i wyliczanie elementów podrzędnych.These include creating, deleting, renaming, moving a child node, and enumerating children. Po zmodyfikowaniu węzła należy zatwierdzić zmiany w celu ich zapisania w drzewie.After you modify a node, you must commit your changes in order for them to be saved to the tree. Aby uzyskać więcej informacji, zobacz Właściwość CommitChanges.For more information, see the CommitChanges property.

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.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

Hierarchia Active Directory Domain Services zawiera maksymalnie kilka tysięcy węzłów.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Każdy węzeł reprezentuje obiekt, taki jak drukarka sieciowa lub użytkownik w domenie.Each node represents an object, such as a network printer or a user in a domain. Sieci firmowe stale zmieniają się w miarę zatrudniania nowych pracowników, a także do dodawania obiektów, takich jak drukarki sieciowe i komputery.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Technologia Active Directory Service Interfaces (ADSI) umożliwia programistyczne Dodawanie tych obiektów do drzewa katalogów.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Aby utworzyć wpis katalogu w hierarchii, użyj właściwości Children.To create a directory entry in the hierarchy, use the Children property. Właściwość Children jest kolekcją, która udostępnia metodę Add, za pomocą której można dodać węzeł do kolekcji bezpośrednio poniżej węzła nadrzędnego, z którym użytkownik jest aktualnie powiązany.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. Podczas dodawania węzła do kolekcji należy określić nazwę nowego węzła i nazwę szablonu schematu, który ma zostać skojarzony z węzłem.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Na przykład możesz chcieć użyć schematu zatytułowanego "Computer", aby dodać nowe komputery do hierarchii.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Ta klasa zawiera również buforowanie atrybutu, co może być przydatne w przypadku optymalizowania ruchu sieciowego.This class also contains attribute caching, which can be useful for optimizing network traffic. Aby użyć buforowania atrybutów, zapoznaj się z właściwością UsePropertyCache.To use attribute caching, see the UsePropertyCache property.

Klasy skojarzone ze składnikiem DirectoryEntry mogą być używane z dowolnymi dostawcami usługi Active Directory Domain Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Niektórzy z bieżących dostawców są Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) i WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Uwaga

Przed użyciem tej klasy zakłada się, że masz ogólne zrozumienie Active Directory Domain Services.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Aby uzyskać więcej informacji, zobacz Omówienie przestrzeni nazw System.DirectoryServices.For more information, see the System.DirectoryServices namespace overview.

Konstruktory

DirectoryEntry()

Inicjuje nowe wystąpienie klasy DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object)

Inicjuje nowe wystąpienie klasy DirectoryEntry, która wiąże się z określonym natywnym obiektem Active Directory Domain Services.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String)

Inicjuje nowe wystąpienie klasy DirectoryEntry, która wiąże to wystąpienie z węzłem w Active Directory Domain Services znajdującym się w określonej ścieżce.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String)

Inicjuje nowe wystąpienie klasy DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes)

Inicjuje nowe wystąpienie klasy DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Właściwości

AuthenticationType

Pobiera lub ustawia typ uwierzytelniania, który ma być używany.Gets or sets the type of authentication to use.

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
Children

Pobiera wpisy podrzędne tego węzła w hierarchii Active Directory Domain Services.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container

Pobiera IContainer, który zawiera Component.Gets the IContainer that contains the Component.

(Odziedziczone po Component)
DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Component.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Guid

Pobiera identyfikator GUID DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name

Pobiera nazwę obiektu jako nazwanego za pomocą źródłowej usługi katalogowej.Gets the name of the object as named with the underlying directory service.

NativeGuid

Pobiera identyfikator GUID DirectoryEntry, który został zwrócony przez dostawcę.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject

Pobiera natywny obiekt interfejsów usługi Active Directory (ADSI).Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity

Pobiera lub ustawia deskryptor zabezpieczeń dla tego wpisu.Gets or sets the security descriptor for this entry.

Options

Pobiera opcje specyficzne dla dostawcy dla tego wpisu.Gets the provider-specific options for this entry.

Parent

Pobiera element nadrzędny tego wpisu w hierarchii Active Directory Domain Services.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password

Ustawia hasło, które ma być używane podczas uwierzytelniania klienta.Sets the password to use when authenticating the client.

Path

Pobiera lub ustawia ścieżkę dla tego DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties

Pobiera Active Directory Domain Services właściwości dla tego obiektu DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName

Pobiera nazwę klasy schematu dla tego obiektu DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry

Pobiera obiekt schematu dla tego wpisu.Gets the schema object for this entry.

Site

Pobiera lub ustawia ISite Component.Gets or sets the ISite of the Component.

(Odziedziczone po Component)
UsePropertyCache

Pobiera lub ustawia wartość wskazującą, czy pamięć podręczną ma być zatwierdzana po każdej operacji.Gets or sets a value indicating whether the cache should be committed after each operation.

Username

Pobiera lub ustawia nazwę użytkownika do użycia podczas uwierzytelniania klienta.Gets or sets the user name to use when authenticating the client.

Metody

Close()

Zamyka obiekt DirectoryEntry i zwalnia wszystkie zasoby systemowe, które są skojarzone z tym składnikiem.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges()

Zapisuje zmiany wprowadzone do wpisu katalogu w źródłowym magazynie katalogów.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry)

Tworzy kopię tego wpisu jako elementu podrzędnego określonego elementu nadrzędnego.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String)

Tworzy kopię tego obiektu DirectoryEntry jako element podrzędny określonego obiektu nadrzędnego DirectoryEntry z określoną nową nazwą.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
DeleteTree()

Usuwa ten wpis i całe poddrzewo z hierarchii Active Directory Domain Services.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Usuwa zasoby (inne niż pamięć) używane przez DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Exists(String)

Określa, czy określona ścieżka reprezentuje rzeczywisty wpis w usłudze katalogowej.Determines if the specified path represents an actual entry in the directory service.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Container.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
Invoke(String, Object[])

Wywołuje metodę dla natywnego obiektu Active Directory Domain Services.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String)

Pobiera właściwość z natywnego obiektu Active Directory Domain Services.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[])

Ustawia właściwość obiektu Active Directory Domain Services macierzystego.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
MoveTo(DirectoryEntry)

Przenosi ten obiekt DirectoryEntry do określonego elementu nadrzędnego.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String)

Przenosi ten obiekt DirectoryEntry do określonego elementu nadrzędnego i zmienia jego nazwę na określoną wartość.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache()

Ładuje wartości właściwości dla tego obiektu DirectoryEntry do pamięci podręcznej właściwości.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[])

Ładuje wartości określonych właściwości do pamięci podręcznej właściwości.Loads the values of the specified properties into the property cache.

Rename(String)

Zmienia nazwę tego obiektu DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString()

Zwraca String zawierający nazwę Component, jeśli istnieje.Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie metody Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Dotyczy