DirectoryContext Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
La clase DirectoryContext identifica un directorio concreto y las credenciales que se utilizan para obtener acceso al directorio.
public ref class DirectoryContext
public class DirectoryContext
type DirectoryContext = class
Public Class DirectoryContext
- Herencia
-
DirectoryContext
Comentarios
Se debe crear un contexto de directorio antes de tener acceso a los métodos y propiedades de un objeto de directorio System.DirectoryServices.ActiveDirectory, como un dominio o bosque.
Al crear un contexto de directorio, las credenciales actuales del proceso o las credenciales alternativas se pueden aplicar a ese contexto mediante el constructor adecuado. Estas credenciales determinan los permisos que están en vigor cuando el programa accede a objetos de directorio. Dado que Servicios de dominio de Active Directory objetos pueden protegerse contra la recuperación o modificación por parte de usuarios no administrativos, el uso de credenciales alternativas con permiso para acceder a los objetos de destino a veces es necesario para una funcionalidad de programa adecuada.
La tabla siguiente contiene una lista de los tipos de destino permitidos y una descripción del formato de la cadena de destino.
Tipo de destino | MiembroDirectoryContextType | Formato de nombre de destino |
---|---|---|
Controlador de dominio | DirectoryServer | Nombre DNS del controlador de dominio. |
Instancia de AD LDS | DirectoryServer | El nombre DNS del servidor AD LDS y el número de puerto LDAP, por ejemplo, ad_lds_instance.fabrikam.com:389. |
Domain | Domain | Nombre DNS del dominio, por ejemplo, sales.corp.fabrikam.com. |
Bosque | Forest | Nombre DNS del bosque, por ejemplo, corp.fabrikam.com. |
Partición de aplicación | ApplicationPartition | Nombre DNS de la partición de la aplicación. |
Conjunto de configuración de AD LDS | ConfigurationSet | Una de las palabras clave asociadas al punto de conexión de servicio registrado por las instancias de AD LDS para el conjunto de configuración. |
Constructores
DirectoryContext(DirectoryContextType) |
Inicializa una nueva instancia de la clase DirectoryContext del tipo especificado que contiene las credenciales del contexto del usuario actual. |
DirectoryContext(DirectoryContextType, String) |
Inicializa una nueva instancia de la clase DirectoryContext del tipo especificado que contiene el nombre especificado y las credenciales del contexto del usuario actual. |
DirectoryContext(DirectoryContextType, String, String) |
Inicializa una nueva instancia de la clase DirectoryContext del tipo especificado que contiene el nombre de usuario y la contraseña especificados. |
DirectoryContext(DirectoryContextType, String, String, String) |
Inicializa una nueva instancia de la clase DirectoryContext del tipo especificado que contiene el destino, el nombre de usuario y la contraseña especificados. |
Propiedades
ContextType |
Obtiene el tipo del objeto de contexto. |
Name |
Obtiene el nombre del contexto. |
UserName |
Obtiene el nombre de usuario del contexto. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |