Compartir a través de


PrincipalContext Constructores

Definición

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
Source:
Context.cs
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

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

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

Se aplica a

PrincipalContext(ContextType, String)

Source:
Context.cs
Source:
Context.cs
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

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

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

Se aplica a

PrincipalContext(ContextType, String, String)

Source:
Context.cs
Source:
Context.cs
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

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.

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.

Se aplica a

PrincipalContext(ContextType, String, String, ContextOptions)

Source:
Context.cs
Source:
Context.cs
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

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.

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.

Se aplica a

PrincipalContext(ContextType, String, String, String)

Source:
Context.cs
Source:
Context.cs
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

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.

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

Se aplica a

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

Source:
Context.cs
Source:
Context.cs
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

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.

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.

Se aplica a

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

Source:
Context.cs
Source:
Context.cs
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

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.

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.

Se aplica a