PrincipalContext Constructores

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Inicializa una nueva instancia de la clase PrincipalContext.

Sobrecargas

PrincipalContext(ContextType)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto especificado.
PrincipalContext(ContextType, String)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo y el nombre de contexto especificados.
PrincipalContext(ContextType, String, String)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, nombre y contenedor especificados.
PrincipalContext(ContextType, String, String, ContextOptions)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contendor y las opciones de contexto especificados.
PrincipalContext(ContextType, String, String, String)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el nombre de usuario y la contraseña especificados.
PrincipalContext(ContextType, String, String, String, String)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contenedor, el nombre de usuario y la contraseña especificados.
PrincipalContext(ContextType, String, String, ContextOptions, String, String)	Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contenedor, las opciones de contexto, el nombre de usuario y la contraseña especificados.

Comentarios

Los PrincipalContext constructores realizan la validación de los parámetros y el servidor, pero no intentan validar las credenciales.

Cuando se crea el objeto de contexto principal sin especificar un contenedor, se puede usar para representar varios contenedores distintos. Se puede usar un contenedor como base de operaciones de consulta, mientras que los contenedores adicionales pueden contener objetos de entidad de seguridad recién creados. Por ejemplo, cuando se insertan usuarios o grupos en el tipo de contexto de dominio, account Management API usa el contenedor de usuarios conocido predeterminado, "CN=Users,DC=Fabrikam,DC=com". Cuando los equipos se insertan en el almacén, la API usa el contenedor predeterminado "CN=Computers,DC=Fabrikam,DC=com". Tenga en cuenta que el administrador de dominio puede cambiar los nombres de contenedor predeterminados. Puesto que los constructores de objetos de entidad de seguridad solo pueden especificar un contexto principal, los contextos adicionales se exponen como el comportamiento predeterminado cuando la aplicación crea un contexto de dominio sin especificar un contenedor. Dado que el directorio de la aplicación no tiene contenedores conocidos, la aplicación debe especificar un contenedor en el constructor o ArgumentException se produce . Dado que SAM no tiene contenedores, se produce una ArgumentException excepción si la aplicación intenta especificar un contenedor en el constructor.

En cada versión del constructor que toma un nombre de usuario como parámetro, la userName cadena puede tener varios formatos diferentes. Los tres nameFormats admitidos para son Nt4Name, UserPrincipalName y SamAccountName. Para obtener más información sobre los formatos de nombre, consulte la documentación de ADS_NAME_TYPE_ENUM.

PrincipalContext(ContextType)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto especificado.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

Excepciones

ArgumentException

Se debe especificar un nombre o contenedor cuando se use el contexto de directorio de aplicaciones.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

PrincipalContext(ContextType, String)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo y el nombre de contexto especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

Excepciones

ArgumentException

Se debe especificar un nombre cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

PrincipalContext(ContextType, String, String)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, nombre y contenedor especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

container

String

Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en la raíz y todas las inserciones, en este contenedor.

En los tipos de contexto de Domain y ApplicationDirectory, este parámetro es el nombre distintivo de un objeto contenedor.

En los tipos de contexto Machine, este parámetro se tiene que establecer en null.

Excepciones

ArgumentException

No se puede especificar un contenedor cuando se define un tipo de contexto de Machine en el parámetro contextType.

Se debe definir un nombre o contenedor cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

Comentarios

InvalidOperationException Se puede producir en llamadas de operaciones de directorio posteriores que se conectan al servidor si el contenedor especificado para un Domain contexto principal no es un contenedor válido. Un contenedor se define como un objeto cuya clase de esquema tiene las clases principales, ya sea user, group o computer, en su atributo possibleInferiors.

PrincipalContext(ContextType, String, String, ContextOptions)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contendor y las opciones de contexto especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

container

String

Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en la raíz y todas las inserciones, en este contenedor.

En los tipos de contexto de Domain y ApplicationDirectory, este parámetro es el nombre distintivo de un objeto contenedor.

En los tipos de contexto Machine, este parámetro se tiene que establecer en null.

options

ContextOptions

Combinación de uno o más valores de la enumeración ContextOptions que especifican las opciones usadas para enlazar al servidor. Si el valor de este parámetro es null, las opciones predeterminadas son ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Excepciones

ArgumentException

No se puede especificar un contenedor cuando se define un tipo de contexto de Machine en el parámetro contextType.

Se debe definir un nombre o contenedor cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

El parámetro options no contiene ninguna combinación de valores de la enumeración ContextOptions válidos.

Comentarios

InvalidOperationException Se puede producir en llamadas de operaciones de directorio posteriores que se conectan al servidor si el contenedor especificado para un Domain contexto principal no es un contenedor válido. Un contenedor se define como un objeto cuya clase de esquema tiene las clases principales, ya sea user, group o computer, en su atributo possibleInferiors.

PrincipalContext(ContextType, String, String, String)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el nombre de usuario y la contraseña especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, userName As String, password As String)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

userName

String

Nombre de usuario que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales del proceso actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

password

String

Contraseña que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales del proceso actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

Excepciones

ArgumentException

Los parámetros username y password han de tener el valor null o contener un valor.

Se debe especificar un nombre cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

PrincipalContext(ContextType, String, String, String, String)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contenedor, el nombre de usuario y la contraseña especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

container

String

Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en la raíz y todas las inserciones, en este contenedor.

En los tipos de contexto de Domain y ApplicationDirectory, este parámetro es el nombre distintivo de un objeto contenedor.

En los tipos de contexto Machine, este parámetro se tiene que establecer en null.

userName

String

Nombre de usuario que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

password

String

Contraseña que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

Excepciones

ArgumentException

Los parámetros username y password han de tener el valor null o contener un valor.

No se puede especificar un contenedor cuando se define un tipo de contexto de Machine en el parámetro contextType.

Se deben especificar name o container cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

Comentarios

InvalidOperationException Se puede producir en llamadas de operaciones de directorio posteriores que se conectan al servidor si el contenedor especificado para un Domain contexto principal no es un contenedor válido. Un contenedor se define como un objeto cuya clase de esquema tiene las clases principales, ya sea user, group o computer, en su atributo possibleInferiors.

PrincipalContext(ContextType, String, String, ContextOptions, String, String)

Source:

Context.cs

Inicializa una nueva instancia de la clase PrincipalContext con el tipo de contexto, el nombre, el contenedor, las opciones de contexto, el nombre de usuario y la contraseña especificados.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)

Parámetros

contextType

ContextType

Valor de una enumeración ContextType que especifica el tipo de almacén del contexto de entidad de seguridad.

name

String

Nombre del dominio o servidor de los tipos de contexto de Domain, nombre de equipo para los nombres de contexto de Machine o nombre del servidor y puerto que hospeda la instancia de ApplicationDirectory.

Si el nombre es null para un tipo de contexto de Domain, este contexto es un controlador de dominio en la entidad de seguridad del usuario bajo la que se ejecuta el subproceso. Si el nombre es null para el tipo de contexto de Machine, este es el nombre del equipo local. Este parámetro no puede ser null para los tipos de contexto de ApplicationDirectory.

container

String

Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en la raíz y todas las inserciones, en este contenedor.

En los tipos de contexto de Domain y ApplicationDirectory, este parámetro es el nombre distintivo de un objeto contenedor.

En los tipos de contexto Machine, este parámetro se tiene que establecer en null.

options

ContextOptions

Combinación de uno o más valores de la enumeración ContextOptions que especifican las opciones usadas para enlazar al servidor. Si el valor de este parámetro es null, las opciones predeterminadas son ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

userName

String

Nombre de usuario que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

password

String

Contraseña que se usa para conectarse al almacén. Si el valor de los parámetros userName y password es null, se usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, userName y password no deben tener el valor null y las credenciales que especifican se usan para conectar con el almacén.

Excepciones

ArgumentException

Los parámetros username y password han de tener el valor null o contener un valor.

No se puede especificar un contenedor cuando se define un tipo de contexto de Machine en el parámetro contextType.

Se debe definir un nombre o contenedor cuando se especifica ApplicationDirectory en el parámetro contextType.

InvalidEnumArgumentException

El parámetro contextType no contiene ningún valor válido de la enumeración ContextType.

El parámetro options no contiene ninguna combinación de valores de la enumeración ContextOptions válidos.

Comentarios

InvalidOperationException Se puede producir en llamadas de directorio posteriores que se conectan al servidor si el contenedor especificado para un Domain contexto de entidad de seguridad no es un contenedor válido. Un contenedor se define como un objeto cuya clase de esquema tiene las clases principales, ya sea user, group o computer, en su atributo possibleInferiors.