PrincipalContext Constructores
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í.
Inicializa una nueva instancia de la clase PrincipalContext.
Sobrecargas
| Nombre | Description |
|---|---|
| PrincipalContext(ContextType) |
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto especificado. |
| PrincipalContext(ContextType, String) |
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto y el nombre especificados. |
| PrincipalContext(ContextType, String, String) |
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto, el nombre y el contenedor especificados. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto, el nombre, el contenedor y las opciones de contexto especificados. |
| PrincipalContext(ContextType, String, String, String) |
Inicializa una nueva instancia de la PrincipalContext clase 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 PrincipalContext clase 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 PrincipalContext clase 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. Un contenedor se puede usar como base de operaciones de consulta, mientras que otros contenedores pueden contener objetos de entidad de seguridad recién creados. Por ejemplo, cuando los usuarios o grupos se insertan en el tipo de contexto de dominio, la API de administración de cuentas 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. Dado que los constructores de objetos principales solo pueden especificar un contexto principal, se exponen contextos adicionales como 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 se produce .ArgumentException 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
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase 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.PrincipalContextPublic Sub New (contextType As ContextType)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
Excepciones
Se debe especificar un nombre o contenedor al usar el contexto del directorio de la aplicación.
El contextType parámetro no contiene un valor de enumeración válido ContextType .
Se aplica a
PrincipalContext(ContextType, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto y el nombre 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
Excepciones
Se debe especificar un nombre cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
Se aplica a
PrincipalContext(ContextType, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto, el nombre y el 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
- container
- String
Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en esta raíz y todas las inserciones se realizan en este contenedor.
Para Domain los tipos de contexto y ApplicationDirectory , este parámetro es el nombre distintivo de un objeto contenedor.
Para Machine los tipos de contexto, este parámetro debe establecerse nullen .
Excepciones
No se puede especificar un contenedor cuando se especifica el Machine tipo de contexto en el contextType parámetro .
Se debe especificar un nombre o contenedor cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
Comentarios
InvalidOperationException Se puede producir en llamadas posteriores de directorio 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
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase con el tipo de contexto, el nombre, el contenedor 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
- container
- String
Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en esta raíz y todas las inserciones se realizan en este contenedor.
Para Domain los tipos de contexto y ApplicationDirectory , este parámetro es el nombre distintivo de un objeto contenedor.
Para Machine los tipos de contexto, este parámetro debe establecerse nullen .
- options
- ContextOptions
Combinación de uno o varios ContextOptions valores de enumeración que especifican las opciones que se usan para enlazar con el servidor. Si este parámetro es null, las opciones predeterminadas son ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Excepciones
No se puede especificar un contenedor cuando se especifica el Machine tipo de contexto en el contextType parámetro .
Se debe especificar un nombre o contenedor cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
El options parámetro no contiene una combinación de valores de enumeración válidos ContextOptions .
Comentarios
InvalidOperationException Se puede producir en llamadas posteriores de directorio 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
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, userName As String, password As String)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
- userName
- String
Nombre de usuario que se usa para conectarse a la tienda. Si los userName parámetros y password son , nullse usan las credenciales del proceso actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
- password
- String
Contraseña usada para conectarse al almacén. Si los userName parámetros y password son , nullse usan las credenciales del proceso actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
Excepciones
Los userName parámetros y password deben ser null o contener un valor .
Se debe especificar un nombre cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
Se aplica a
PrincipalContext(ContextType, String, String, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)Parámetros
- contextType
- ContextType
Valor ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
- container
- String
Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en esta raíz y todas las inserciones se realizan en este contenedor.
Para Domain los tipos de contexto y ApplicationDirectory , este parámetro es el nombre distintivo de un objeto contenedor.
Para Machine los tipos de contexto, este parámetro debe establecerse nullen .
- userName
- String
Nombre de usuario que se usa para conectarse a la tienda. Si los userName parámetros y password son , nullse usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
- password
- String
Contraseña usada para conectarse al almacén. Si los userName parámetros y password son , nullse usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
Excepciones
Los userName parámetros y password deben ser null o contener un valor .
No se puede especificar un contenedor cuando se especifica el Machine tipo de contexto en el contextType parámetro .
Se name debe especificar o container cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
Comentarios
InvalidOperationException Se puede producir en llamadas posteriores de directorio 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
- Source:
- Context.cs
Inicializa una nueva instancia de la PrincipalContext clase 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.PrincipalContextPublic 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 ContextType de enumeración que especifica el tipo de almacén para el contexto principal.
- name
- String
El nombre del dominio o servidor para Domain los tipos de contexto, el nombre de la máquina para Machine los tipos de contexto o el nombre del servidor y el puerto que hospeda la ApplicationDirectory instancia.
Si el nombre es null para un Domain tipo de contexto, este contexto es un controlador de dominio para el dominio de la entidad de seguridad de usuario en la que se ejecuta el subproceso. Si el nombre es null para un Machine tipo de contexto, este es el nombre del equipo local. Este parámetro no puede ser null para ApplicationDirectory los tipos de contexto.
- container
- String
Contenedor del almacén que se va a usar como raíz del contexto. Todas las consultas se realizan en esta raíz y todas las inserciones se realizan en este contenedor.
Para Domain los tipos de contexto y ApplicationDirectory , este parámetro es el nombre distintivo de un objeto contenedor.
Para Machine los tipos de contexto, este parámetro debe establecerse nullen .
- options
- ContextOptions
Combinación de uno o varios ContextOptions valores de enumeración que las opciones usadas para enlazar con el servidor. Si 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 a la tienda. Si los userName parámetros y password son , nullse usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
- password
- String
Contraseña usada para conectarse al almacén. Si los userName parámetros y password son , nullse usan las credenciales predeterminadas de la entidad de seguridad actual. De lo contrario, tanto como userNamepassword deben ser no NULL y las credenciales que especifican se usan para conectarse al almacén.
Excepciones
Los userName parámetros y password deben ser null o contener un valor .
No se puede especificar un contenedor cuando se especifica el Machine tipo de contexto en el contextType parámetro .
Se debe especificar un nombre o contenedor cuando ApplicationDirectory se especifica en el contextType parámetro .
El contextType parámetro no contiene un valor de enumeración válido ContextType .
El options parámetro no contiene una combinación de valores de enumeración válidos ContextOptions .
Comentarios
InvalidOperationException Se puede producir en llamadas posteriores de directorio 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.
