System.DirectoryServices 1.0.5000.0 System.Reflection.AssemblyKeyFile(KeyFile="../msfinal.pub") System.Reflection.AssemblyDelaySign(DelaySign=True) System.Runtime.InteropServices.ComVisible(Value=False) System.Resources.NeutralResourcesLanguage(CultureName="en-US") System.Reflection.AssemblyInformationalVersion(InformationalVersion="0.0.0.1") System.Reflection.AssemblyDefaultAlias(DefaultAlias="System.DirectoryServices.dll") System.CLSCompliant(IsCompliant=True) System.Reflection.AssemblyTrademark(Trademark="") System.Reflection.AssemblyCopyright(Copyright="(c) 2003 Various Authors") System.Reflection.AssemblyProduct(Product="MONO CLI") System.Reflection.AssemblyCompany(Company="MONO development team") System.Reflection.AssemblyConfiguration(Configuration="Development version") System.Reflection.AssemblyDescription(Description="System.DirectoryServices.dll") System.Reflection.AssemblyTitle(Title="System.DirectoryServices.dll") System.Resources.SatelliteContractVersion(Version="1.0.5000.0") System.ComponentModel.Component System.ComponentModel.IComponent System.IDisposable System.ComponentModel.TypeConverter(ConverterTypeName="System.DirectoryServices.Design.DirectoryEntryConverter, System.DirectoryServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
- Constructor
  To be added.

  Initializes a new instance of the class.

- Constructor

  This constructor enables a program to use the methods and properties of the class on a native Active Directory Domain Services object that implements the IADs interface through a native API. For more information about the IADs interface, see the topic IADs in the MSDN Library at http://msdn.microsoft.com/library.

  Initializes a new instance of the class that binds to the specified native Active Directory Domain Services object.

  The name of the native Active Directory Domain Services object to bind to.
- Constructor
  To be added.

  Initializes a new instance of the class that binds this instance to the node in Active Directory Domain Services located at the specified path.

  The path at which to bind the to the directory. The property is initialized to this value.
- Constructor
  To be added.
  To be added.
  To be added.

  Initializes a new instance of the class.

  The user name to use when authenticating the client. The property is initialized to this value.
- Constructor
  To be added.
  To be added.
  To be added.

  Initializes a new instance of the class.

  The user name to use when authenticating the client. The property is initialized to this value.
  One of the values. The property is initialized to this value.
- Method
  System.Void

  Call this method to release unmanaged system resources, without waiting for garbage collection.

  Following a call to , any operations on the might raise exceptions.

  Closes the object and releases any system resources that are associated with this component.

- Method
  System.DirectoryServices.DirectoryEntry ``

  If is true, call on the new object to make the copy permanent.

  The Lightweight Directory Access Protocol (LDAP) provider does not currently support the method.

  Creates a copy of this entry as a child of the specified parent.

  A object that represents the copy of this entry as a child of the new parent.

  The distinguished name of the object that will be the parent for the copy that is being created.
- Method
  System.Void

  Of the Active Directory Service Interfaces (ADSI) system-supplied providers, only the Lightweight Directory Access Protocol (LDAP) currently supports this operation.

  The entry and its entire subtree are deleted from the Active Directory Domain Services hierarchy.

  ## Security

  Use for deleting entries from the Active Directory Domain Services hierarchy. Associated enumeration: .

  Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

- Method
  System.Boolean `` To be added.

  Determines if the specified path represents an actual entry in the directory service.

  true if the specified path represents a valid entry in the directory service; otherwise, false.

  The path of the entry to verify.
- Method
  System.Void ``

  If is true, call the method on the new object to make the move permanent.

  Moves this object to the specified parent.

  The parent to which you want to move this entry.
- Method
  System.Void `` ``

  If is true, call on the new object to make the move permanent.

  Moves this object to the specified parent and changes its name to the specified value.

  The parent to which you want to move this entry. The new name of this entry.
- Method
  System.Void ``

  This will also affect the path that is used to refer to this entry.

  If is true, be sure to call the method on the new object to make the move permanent.

  Changes the name of this object.

  The new name of the entry.
- Method
  System.Object `` `System.ParamArray`

  If the return value of the native method implements the IADs interface, a corresponding is returned. For more information about the IADs interface, see the topic IADs in the MSDN Library at http://msdn.microsoft.com/library.

  Calls a method on the native Active Directory Domain Services object.

  The return value of the invoked method.

  The name of the method to invoke. An array of type objects that contains the arguments of the method to invoke.
- Method
  System.DirectoryServices.DirectoryEntry `` ``

  The Lightweight Directory Access Protocol (LDAP) provider does not currently support this method.

  If is true, call on the new object to make the copy permanent.

  Creates a copy of this object, as a child of the specified parent object, with the specified new name.

  A renamed copy of this entry as a child of the specified parent.

  The DN of the object that will be the parent for the copy that is being created. The name of the copy of this entry.
- Method
  System.Void

  By default, changes to properties are made locally to a cache, and property values to be read are cached after the first read. For more information, see .

  Changes made to the cache include changes to the properties as well as calls to (if this is the newly created entry).

  If you call before calling , any uncommitted changes to the property cache will be lost.

  ## Security

  Use the class for reading, writing, deleting, changing, and adding to the Active Directory Domain Services hierarchy. Associated enumeration: .

  Saves changes that are made to a directory entry to the underlying directory store.

- Method
  System.Void

  Any uncommitted changes to the property cache will be lost. Use the method to persist changes to the directory store.

  Loads the property values for this object into the property cache.

- Method
  System.Void `` To be added.

  Any uncommitted changes to the property cache will be lost. Use to persist changes to the directory store.

  Loads the values of the specified properties into the property cache.

- Property
  System.ComponentModel.DefaultValue(Value=0)
  System.DirectoryServices.DSDescription(Description="Type of authentication to use while Binding to Ldap server")
  System.DirectoryServices.AuthenticationTypes To be added.

  Prior to dnprdnlong, the default value is . Beginning with dnprdnlong, the default value is .

  Gets or sets the type of authentication to use.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="Child entries of this node")
  System.DirectoryServices.DirectoryEntries To be added.

  The child entries are only the immediate children of this node.

  Use this property to find, retrieve, or create a directory entry in the hierarchy. This property is a collection that, along with the usual iteration capabilities, provides an method through which you add a node to the collection directly below the parent node that you are currently bound to. 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. For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

  By default, changes are made locally to a cache. After you modify or add a node, you must call the method to commit your changes in order for them to be saved to the tree. If you call before calling , any uncommitted changes to the property cache will be lost. For more information, see the and methods, and the property.

  Gets the child entries of this node in the Active Directory Domain Services hierarchy.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="A globally unique identifier for this DirectoryEntry")
  System.Guid To be added.

  When binding to an object in Active Directory Domain Services, use the property.

  Gets the GUID of the .

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="The name of the object as named with the underlying directory")
  System.String To be added.

  This name, along with , distinguishes this entry from its siblings and must be unique among its siblings in each container.

  Gets the name of the object as named with the underlying directory service.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="This entry's parent in the Ldap Directory hierarchy.")
  System.DirectoryServices.DirectoryEntry To be added. To be added.

  Gets this entry's parent in the Active Directory Domain Services hierarchy.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="The globally unique identifier of the DirectoryEntry, as returned from the provider")
  System.String To be added.

  Use the property when binding an object in Active Directory Domain Services.

  The Lightweight Directory Access Protocol (LDAP) provider returns the globally unique identifier of a in a different format than the Internet Information Services (IIS), Novell NetWare Directory Server (NDS), and WinNT providers.

  Gets the GUID of the , as returned from the provider.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="The native Active Directory Service Interfaces (ADSI) object.")
  System.Object To be added.

  Use this property to cast the native Active Directory Domain Services object, which implements the IADs interface, when you want to use a COM interface. For more information about the IADs interface, see the topic IADs in the MSDN Library at http://msdn.microsoft.com/library.

  This object is for advanced scenarios that cannot be accomplished with the classes alone. To use it, you need to import one of the COM interfaces from the IADs family, then cast this property to that interface.

  Gets the native Active Directory Service Interfaces (ADSI) object.

- Property
  System.ComponentModel.DefaultValue(Value=True)
  System.DirectoryServices.DSDescription(Description="Determines if a cache should be used.")
  System.Boolean To be added.

  By default, changes to properties are made locally to a cache, and property values to be read are cached after the first read. When the property is true, access to the object's properties is faster. Setting this to false will cause the cache to be committed after each operation.

  If the property is true and you want to commit cached changes, call the method. To update values in the cache after changes to the directory are made, call the method.

  If you call before calling , any uncommitted changes to the property cache will be lost.

  The Internet Information Services (IIS) provider does not support committing the cache after each operation.

  Gets or sets a value indicating whether the cache should be committed after each operation.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DefaultValue(Value=null)
  System.DirectoryServices.DSDescription(Description="The password to use when authenticating the client.")
  System.String To be added.

  You can set the and properties to specify alternate credentials with which to access the information in Active Directory Domain Services. Any other objects retrieved from this instance (for example, through ) are automatically created with the same alternate credentials.

  Sets the password to use when authenticating the client.

- Property
  System.ComponentModel.TypeConverter(ConverterTypeName="System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DefaultValue(Value=null)
  System.DirectoryServices.DSDescription(Description="The user name to use when authenticating the client.")
  System.String To be added.

  You can set the and in order to specify alternate credentials with which to access the information in Active Directory Domain Services. Any other objects retrieved from this instance (for example, through ) are automatically created with the same alternate credentials.

  Gets or sets the user name to use when authenticating the client.

- Property
  System.ComponentModel.TypeConverter(ConverterTypeName="System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.ComponentModel.RecommendedAsConfigurable(RecommendedAsConfigurable=True)
  System.ComponentModel.DefaultValue(Value="")
  System.DirectoryServices.DSDescription(Description="The path for this DirectoryEntry.")
  System.String To be added.

  The property uniquely identifies this entry in a networked environment. This entry can always be retrieved using this .

  Setting the retrieves a new entry from the directory store; it does not change the path of the currently bound entry.

  The classes associated with the component can be used with any of the Active Directory Domain Services service providers. Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

  The section of the that identifies the provider (precedes "://") is case-sensitive. For example, "LDAP://" or "WinNT://".

  The syntax for the property varies according to the provider. Some common scenarios are:

  WinNT

  Connect to a group on a computer. For example, "WinNT://<domain name>/<computer name>/<group name>". If you are connecting to a local computer, "WinNT://<computer name>/<group name>".

  Connect to a user on a computer. For example, "WinNT://<domain name>/<computer name>/<user name>". If you are connecting to a local computer, "WinNT://<computer name>/<user name>".

  Connect to services on a computer. For example, "WinNT://<domain name>/<computer name>/<service name>". If you are connecting to a local computer, "WinNT://<computer name>/<service name>".

  Discover all domains on the network. For example, "WinNT:" The domains can be found by enumerating the children of this entry.

  LDAP

  Connect to a group in a domain. For example, "LDAP://CN=<group name>, CN =<Users>, DC=<domain component>, DC=<domain component>,...".

  Connect to a user in a domain. For example, "LDAP://CN=<full user name>, CN=<Users>, DC=<domain component>, DC=<domain component>,...".

  Connect to computers in a domain. For example, "LDAP://CN=<computer name>, CN=<Computers>, DC=<domain component>, DC=<domain component>,...".

  IIS

  Connect to a Web directory. For example, "IIS://LocalHost/W3SVC/1/ROOT/<Web directory name>".

  To bind to the current domain using LDAP, use the path "LDAP://RootDSE", then get the default naming context and rebind the entry. For example:

  `String str = ent.Properties["defaultNamingContext"][0]; DirectoryEntry domain = new DirectoryEntry("LDAP://" + str);`

  For more information, see the documentation for your provider and the topic Using Active Directory Service Interfaces in the MSDN Library at http://msdn.microsoft.com/library.

  Gets or sets the path for this .

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="Properties set on this object.")
  System.DirectoryServices.PropertyCollection To be added.

  If the property is not initialized, calls the ADSI interface IADs::Get method to retrieve the value from the cache. If the underling cache has not been loaded, IADs::Get implicitly calls IADs::GetInfo. This method loads the values of the supported properties that have not been set in the cache from the underlying directory store. Subsequent calls to retrieves the property values in the cache only. To control property cache loading, call .

  Note The property is not supported for use with the Active Directory Client Extension (DSClient) for WinNt4Family.

  Gets the Active Directory Domain Services properties for this object.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="The name of the schema used for this DirectoryEntry.")
  System.String To be added.

  This is the same as the property of the property.

  A object's schema defines its properties and methods.

  Gets the name of the schema class for this object.

- Property
  System.ComponentModel.Browsable(Browsable=False)
  System.ComponentModel.DesignerSerializationVisibility(Visibility=System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.DirectoryServices.DSDescription(Description="The current schema directory entry.")
  System.DirectoryServices.DirectoryEntry To be added.

  An entry's schema determines a list of its mandatory and optional property names.

  You can use this property to find out what properties and methods are available on the associated object.

  Gets the schema object for this entry.

Use this class for binding to objects, or reading and updating attributes. , along with helper classes, provides support for life-cycle management and navigation methods. These include creating, deleting, renaming, moving a child node, and enumerating children. After you modify a node, you must commit your changes in order for them to be saved to the tree. For more information, see the property.

can be used to access regular entries and some, but not all, information from schema entries.

The Active Directory Domain Services hierarchy contains up to several thousand nodes. Each node represents an object, such as a network printer or a user in a domain. Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

To create a directory entry in the hierarchy, use the property. The property is a collection that provides an method, through which you add a node to the collection directly below the parent node that you are currently bound to. 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. For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

This class also contains attribute caching, which can be useful for optimizing network traffic. To use attribute caching, see the property.

The classes associated with the component can be used with any of the Active Directory Domain Services service providers. Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

It is assumed that you have a general understanding of Active Directory Domain Services before using this class. For more information, see the namespace overview.

The class encapsulates a node or object in the Active Directory Domain Services hierarchy.