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 DirectoryContextpublic class DirectoryContexttype DirectoryContext = classPublic 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) |
