PrincipalContext Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe PrincipalContext.
Surcharges
| Nom | Description |
|---|---|
| PrincipalContext(ContextType) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte spécifié. |
| PrincipalContext(ContextType, String) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte et le nom spécifiés. |
| PrincipalContext(ContextType, String, String) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom et le conteneur spécifiés. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur et les options de contexte spécifiés. |
| PrincipalContext(ContextType, String, String, String) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le nom, le nom d’utilisateur et le mot de passe spécifiés. |
| PrincipalContext(ContextType, String, String, String, String) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur, le nom d’utilisateur et le mot de passe spécifiés. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur, les options de contexte, le nom d’utilisateur et le mot de passe spécifiés. |
Remarques
Les PrincipalContext constructeurs effectuent la validation des paramètres et du serveur, mais ne tentent pas de valider les informations d’identification.
Lorsque l’objet de contexte principal est créé sans spécifier de conteneur, il peut être utilisé pour représenter plusieurs conteneurs distincts. Un conteneur peut être utilisé comme base d’opérations de requête, tandis que d’autres conteneurs peuvent contenir des objets principaux nouvellement créés. Par exemple, lorsque des utilisateurs ou des groupes sont insérés dans le type de contexte de domaine, l’API Gestion des comptes utilise le conteneur d’utilisateurs connu par défaut, « CN=Users,DC=Fabrikam,DC=com ». Lorsque les ordinateurs sont insérés dans le magasin, l’API utilise le conteneur « CN=Computers,DC=Fabrikam,DC=com » par défaut. Notez que les noms de conteneur par défaut peuvent être modifiés par l’administrateur de domaine. Étant donné que les constructeurs d’objets principaux ne peuvent spécifier qu’un seul contexte principal, des contextes supplémentaires sont exposés comme comportement par défaut lorsque l’application crée un contexte de domaine sans spécifier de conteneur. Étant donné que le répertoire de l’application n’a pas de conteneurs connus, l’application doit spécifier un conteneur dans le constructeur ou le ArgumentException conteneur est levée. Étant donné que SAM n’a pas de conteneurs, il ArgumentException est levée si l’application tente de spécifier un conteneur dans le constructeur.
Dans chaque version du constructeur qui prend un nom d’utilisateur comme paramètre, la userName chaîne peut se trouver dans différents formats. Les trois NameFormats pris en charge sont Nt4Name, UserPrincipalName et SamAccountName. Pour plus d’informations sur les formats de noms, consultez la documentation ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte spécifié.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
Exceptions
Un nom ou un conteneur doit être spécifié lors de l’utilisation du contexte du répertoire de l’application.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
S’applique à
PrincipalContext(ContextType, String)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte et le nom spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
Exceptions
Un nom doit être spécifié quand ApplicationDirectory il est spécifié dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
S’applique à
PrincipalContext(ContextType, String, String)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom et le conteneur spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
- container
- String
Conteneur sur le magasin à utiliser comme racine du contexte. Toutes les requêtes sont effectuées sous cette racine, et toutes les insertions sont effectuées dans ce conteneur.
Pour les types de contexte et ApplicationDirectory pour Domain les types de contexte, ce paramètre est le nom unique d’un objet conteneur.
Pour Machine les types de contexte, ce paramètre doit être défini sur null.
Exceptions
Un conteneur ne peut pas être spécifié lorsque le Machine type de contexte est spécifié dans le contextType paramètre.
Un nom ou un conteneur doit être spécifié lorsqu’il ApplicationDirectory est spécifié dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
Remarques
Il InvalidOperationException peut être levée dans les appels d’opérations d’annuaire suivants qui se connectent au serveur si le conteneur spécifié pour un Domain contexte principal n’est pas un conteneur valide. Un conteneur est défini comme un objet dont la classe de schéma possède les classes principales, soit l’utilisateur, le groupe ou l’ordinateur, dans son attribut PossibleInferiors.
S’applique à
PrincipalContext(ContextType, String, String, ContextOptions)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur et les options de contexte spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
- container
- String
Conteneur sur le magasin à utiliser comme racine du contexte. Toutes les requêtes sont effectuées sous cette racine, et toutes les insertions sont effectuées dans ce conteneur.
Pour les types de contexte et ApplicationDirectory pour Domain les types de contexte, ce paramètre est le nom unique d’un objet conteneur.
Pour Machine les types de contexte, ce paramètre doit être défini sur null.
- options
- ContextOptions
Combinaison d’une ou plusieurs ContextOptions valeurs d’énumération spécifiant les options utilisées pour établir une liaison au serveur. Si ce paramètre est null, les options par défaut sont ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Exceptions
Un conteneur ne peut pas être spécifié lorsque le Machine type de contexte est spécifié dans le contextType paramètre.
Un nom ou un conteneur doit être spécifié lorsqu’il ApplicationDirectory est spécifié dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
Le options paramètre ne contient pas de combinaison de valeurs d’énumération valides ContextOptions .
Remarques
Il InvalidOperationException peut être levée dans les appels d’opérations d’annuaire suivants qui se connectent au serveur si le conteneur spécifié pour un Domain contexte principal n’est pas un conteneur valide. Un conteneur est défini comme un objet dont la classe de schéma possède les classes principales, soit l’utilisateur, le groupe ou l’ordinateur, dans son attribut PossibleInferiors.
S’applique à
PrincipalContext(ContextType, String, String, String)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le nom, le nom d’utilisateur et le mot de passe spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
- userName
- String
Nom d’utilisateur utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification du processus actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
- password
- String
Mot de passe utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification du processus actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
Exceptions
Les userName paramètres doivent password être null ou contenir une valeur.
Un nom doit être spécifié quand ApplicationDirectory il est spécifié dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
S’applique à
PrincipalContext(ContextType, String, String, String, String)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur, le nom d’utilisateur et le mot de passe spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
- container
- String
Conteneur sur le magasin à utiliser comme racine du contexte. Toutes les requêtes sont effectuées sous cette racine, et toutes les insertions sont effectuées dans ce conteneur.
Pour les types de contexte et ApplicationDirectory pour Domain les types de contexte, ce paramètre est le nom unique d’un objet conteneur.
Pour Machine les types de contexte, ce paramètre doit être défini sur null.
- userName
- String
Nom d’utilisateur utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification par défaut du principal actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
- password
- String
Mot de passe utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification par défaut du principal actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
Exceptions
Les userName paramètres doivent password être null ou contenir une valeur.
Un conteneur ne peut pas être spécifié lorsque le Machine type de contexte est spécifié dans le contextType paramètre.
Une name ou container doit être spécifiée quand ApplicationDirectory elle est spécifiée dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
Remarques
Il InvalidOperationException peut être levée dans les appels d’opérations d’annuaire suivants qui se connectent au serveur si le conteneur spécifié pour un Domain contexte principal n’est pas un conteneur valide. Un conteneur est défini comme un objet dont la classe de schéma possède les classes principales, soit l’utilisateur, le groupe ou l’ordinateur, dans son attribut PossibleInferiors.
S’applique à
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
Initialise une nouvelle instance de la PrincipalContext classe avec le type de contexte, le nom, le conteneur, les options de contexte, le nom d’utilisateur et le mot de passe spécifiés.
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)Paramètres
- contextType
- ContextType
Valeur ContextType d’énumération spécifiant le type de magasin pour le contexte principal.
- name
- String
Nom du domaine ou du serveur pour Domain les types de contexte, nom de l’ordinateur pour Machine les types de contexte, ou nom du serveur et du port hébergeant l’instance ApplicationDirectory .
Si le nom concerne null un Domain type de contexte, ce contexte est un contrôleur de domaine pour le domaine du principal de l’utilisateur sous lequel le thread est en cours d’exécution. Si le nom concerne null un Machine type de contexte, il s’agit du nom de l’ordinateur local. Ce paramètre ne peut pas être null destiné aux ApplicationDirectory types de contexte.
- container
- String
Conteneur sur le magasin à utiliser comme racine du contexte. Toutes les requêtes sont effectuées sous cette racine, et toutes les insertions sont effectuées dans ce conteneur.
Pour les types de contexte et ApplicationDirectory pour Domain les types de contexte, ce paramètre est le nom unique d’un objet conteneur.
Pour Machine les types de contexte, ce paramètre doit être défini sur null.
- options
- ContextOptions
Combinaison d’une ou plusieurs ContextOptions valeurs d’énumération que les options utilisées pour établir une liaison au serveur. Si ce paramètre est null, les options par défaut sont ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Nom d’utilisateur utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification par défaut du principal actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
- password
- String
Mot de passe utilisé pour se connecter au magasin. Si les paramètres et password les userName deux sont les deuxnull, les informations d’identification par défaut du principal actuel sont utilisées. Sinon, les deux userName et password doivent être non null, et les informations d’identification qu’ils spécifient sont utilisées pour se connecter au magasin.
Exceptions
Les userName paramètres doivent password être null ou contenir une valeur.
Un conteneur ne peut pas être spécifié lorsque le Machine type de contexte est spécifié dans le contextType paramètre.
Un nom ou un conteneur doit être spécifié lorsqu’il ApplicationDirectory est spécifié dans le contextType paramètre.
Le contextType paramètre ne contient pas de valeur d’énumération valide ContextType .
Le options paramètre ne contient pas de combinaison de valeurs d’énumération valides ContextOptions .
Remarques
Il InvalidOperationException peut être levée dans les appels d’opérations d’annuaire suivants qui se connectent au serveur si le conteneur spécifié pour un Domain contexte principal n’est pas un conteneur valide. Un conteneur est défini comme un objet dont la classe de schéma possède les classes principales, soit l’utilisateur, le groupe ou l’ordinateur, dans son attribut PossibleInferiors.