Partager via


PrincipalContext Constructeurs

Définition

Initialise une nouvelle instance de la classe PrincipalContext.

Surcharges

PrincipalContext(ContextType)

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte spécifié.

PrincipalContext(ContextType, String)

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte et le nom spécifiés.

PrincipalContext(ContextType, String, String)

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom et le conteneur spécifiés.

PrincipalContext(ContextType, String, String, ContextOptions)

Initialise une nouvelle instance de la classe PrincipalContext 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 classe PrincipalContext avec le type de contexte, le nom, l'utilisateur et le mot de passe spécifiés.

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

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom, le conteneur, l'utilisateur et le mot de passe spécifiés.

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

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom, le conteneur, les options de contexte, l'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 des conteneurs supplémentaires 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 des ordinateurs sont insérés dans le magasin, l’API utilise le conteneur par défaut « CN=Computers,DC=Fabrikam,DC=com ». Notez que les noms de conteneur par défaut peuvent être modifiés par l’administrateur de domaine. Étant donné que les constructeurs d’objet principal ne peuvent spécifier qu’un seul contexte principal, des contextes supplémentaires sont exposés en tant que 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 est levée. Étant donné que SAM n’a pas de conteneurs, une 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 être dans différents formats. Les trois NameFormats pris en charge pour sont Nt4Name, UserPrincipalName et SamAccountName. Pour plus d’informations sur les formats de noms, consultez la documentation ADS_NAME_TYPE_ENUM.

PrincipalContext(ContextType)

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext 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.PrincipalContext
Public Sub New (contextType As ContextType)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

Exceptions

Un nom ou conteneur doit être spécifié lors de l'utilisation du contexte de l'annuaire d'applications.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

S’applique à

PrincipalContext(ContextType, String)

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

Exceptions

Un nom doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

S’applique à

PrincipalContext(ContextType, String, String)

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

container
String

Conteneur du magasin à utiliser comme racine du contexte. Toutes les requêtes sont exécutées sous cette racine, et toutes les insertions sont exécutées dans ce conteneur.

Pour les types de contexte Domain et ApplicationDirectory, ce paramètre est le nom unique d'un objet conteneur.

Pour les types de contexte Machine, ce paramètre doit avoir la valeur null.

Exceptions

Un conteneur ne peut pas être spécifié quand le type de contexte Machine est spécifié dans le paramètre contextType.

Un nom ou un conteneur doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

Remarques

Peut InvalidOperationException ê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 a les classes principales, utilisateur, groupe ou ordinateur, dans son attribut possibleInferiors.

S’applique à

PrincipalContext(ContextType, String, String, ContextOptions)

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

container
String

Conteneur du magasin à utiliser comme racine du contexte. Toutes les requêtes sont exécutées sous cette racine, et toutes les insertions sont exécutées dans ce conteneur.

Pour les types de contexte Domain et ApplicationDirectory, ce paramètre est le nom unique d'un objet conteneur.

Pour les types de contexte Machine, ce paramètre doit avoir la valeur null.

options
ContextOptions

Combinaison d'une ou plusieurs valeurs d'énumération ContextOptions spécifiant les options utilisées lors de la 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é quand le type de contexte Machine est spécifié dans le paramètre contextType.

Un nom ou un conteneur doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

Le paramètre options ne contient pas une combinaison de valeurs d'énumération ContextOptions valides.

Remarques

Peut InvalidOperationException ê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 a les classes principales, utilisateur, groupe ou ordinateur, dans son attribut possibleInferiors.

S’applique à

PrincipalContext(ContextType, String, String, String)

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom, l'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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, userName As String, password As String)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

userName
String

Nom d'utilisateur utilisé pour se connecter au magasin. Si les paramètres userName etpassword sont tous les deux null, les informations d’identification du processus actif sont utilisées. Sinon, userName et password doivent être tous les deux 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 userName etpassword sont tous les deux null, les informations d’identification du processus actif sont utilisées. Sinon, userName et password doivent être tous les deux non null, et les informations d'identification qu'ils spécifient sont utilisées pour se connecter au magasin.

Exceptions

Les paramètres username et password doivent soit être null soit contenir une valeur.

Un nom doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

S’applique à

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

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom, le conteneur, l'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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)

Paramètres

contextType
ContextType

Valeur d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

container
String

Conteneur du magasin à utiliser comme racine du contexte. Toutes les requêtes sont exécutées sous cette racine, et toutes les insertions sont exécutées dans ce conteneur.

Pour les types de contexte Domain et ApplicationDirectory, ce paramètre est le nom unique d'un objet conteneur.

Pour les types de contexte Machine, ce paramètre doit avoir la valeur null.

userName
String

Nom d'utilisateur utilisé pour se connecter au magasin. Si les paramètres userName et password sont tous les deux null, les informations d’identification par défaut de l’entité de sécurité actuelle sont utilisées. Sinon, userName et password doivent être tous les deux 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 userName et password sont tous les deux null, les informations d’identification par défaut de l’entité de sécurité actuelle sont utilisées. Sinon, userName et password doivent être tous les deux non null, et les informations d'identification qu'ils spécifient sont utilisées pour se connecter au magasin.

Exceptions

Les paramètres username et password doivent soit être null soit contenir une valeur.

Un conteneur ne peut pas être spécifié quand le type de contexte Machine est spécifié dans le paramètre contextType.

name ou container doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

Remarques

Peut InvalidOperationException ê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 a les classes principales, utilisateur, groupe ou ordinateur, dans son attribut possibleInferiors.

S’applique à

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

Source:
Context.cs
Source:
Context.cs
Source:
Context.cs

Initialise une nouvelle instance de la classe PrincipalContext avec le type de contexte, le nom, le conteneur, les options de contexte, l'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.PrincipalContext
Public 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 d'énumération ContextType spécifiant le type de magasin pour le contexte de l'entité de sécurité.

name
String

Nom du domaine ou du serveur pour les types de contexte Domain, nom de l'ordinateur pour les types de contexte Machine ou nom du serveur et port hébergeant l'instance de ApplicationDirectory.

Si le nom est null pour un type de contexte Domain, ce contexte est un contrôleur de domaine du domaine de l’entité de sécurité d’utilisateur sous laquelle le thread s’exécute. Si le nom est null pour un type de contexte Machine, c’est le nom de l’ordinateur local. Ce paramètre ne peut pas être null pour les types de contexte ApplicationDirectory.

container
String

Conteneur du magasin à utiliser comme racine du contexte. Toutes les requêtes sont exécutées sous cette racine, et toutes les insertions sont exécutées dans ce conteneur.

Pour les types de contexte Domain et ApplicationDirectory, ce paramètre est le nom unique d'un objet conteneur.

Pour les types de contexte Machine, ce paramètre doit avoir la valeur null.

options
ContextOptions

Combinaison d'une ou plusieurs valeurs d'énumération ContextOptions utilisées par les options pour la 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 userName et password sont tous les deux null, les informations d’identification par défaut de l’entité de sécurité actuelle sont utilisées. Sinon, userName et password doivent être tous les deux 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 userName et password sont tous les deux null, les informations d’identification par défaut de l’entité de sécurité actuelle sont utilisées. Sinon, userName et password doivent être tous les deux non null, et les informations d'identification qu'ils spécifient sont utilisées pour se connecter au magasin.

Exceptions

Les paramètres username et password doivent soit être null soit contenir une valeur.

Un conteneur ne peut pas être spécifié quand le type de contexte Machine est spécifié dans le paramètre contextType.

Un nom ou un conteneur doit être spécifié lorsque ApplicationDirectory est spécifié dans le paramètre contextType.

Le paramètre contextType ne contient pas une valeur d'énumération ContextType valide.

Le paramètre options ne contient pas une combinaison de valeurs d'énumération ContextOptions valides.

Remarques

Peut InvalidOperationException ê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 contient les classes principales, utilisateur, groupe ou ordinateur, dans son attribut possibleInferiors.

S’applique à