PrincipalContext 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
初始化 PrincipalContext 类的新实例。
重载
| PrincipalContext(ContextType) |
使用指定的上下文类型初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String) |
使用指定的上下文类型和名称初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String, String) |
使用指定的上下文类型、名称和容器初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String, String, ContextOptions) |
使用指定的上下文类型、名称、容器和上下文选项初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String, String, String) |
使用指定的上下文类型、名称、用户名和密码初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String, String, String, String) |
使用指定的上下文类型、名称、容器、用户名和密码初始化 PrincipalContext 类的新实例。 |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
使用指定的上下文类型、名称、容器、上下文选项、用户名和密码初始化 PrincipalContext 类的新实例。 |
注解
构造 PrincipalContext 函数执行参数和服务器的验证，但不尝试验证凭据。
在没有指定容器的情况下创建主体上下文对象时，它可用于表示多个不同的容器。 一个容器可用作查询操作的基础，而其他容器可以保存新创建的主体对象。 例如，当用户或组插入域上下文类型时，帐户管理 API 将使用默认的已知用户容器“CN=Users，DC=Fabrikam，DC=com”。 在存储中插入计算机时，API 将使用默认的“CN=Computers，DC=Fabrikam，DC=com”容器。 请注意，域管理员可更改默认容器名称。 由于主体对象构造函数只能指定一个主体上下文，因此当应用程序在不指定容器的情况下创建域上下文时，其他上下文将公开为默认行为。 由于应用程序目录没有已知的容器，因此应用程序必须在构造函数中指定容器，否则 ArgumentException 会引发 。 由于 SAM 没有容器， ArgumentException 因此如果应用程序尝试在构造函数中指定容器，则会引发 。
在采用用户名作为参数的每个构造函数版本中， userName 字符串可以采用各种不同的格式。 支持的三个 NameFormats 是 Nt4Name、UserPrincipalName 和 SamAccountName。 有关名称格式的详细信息，请参阅 ADS_NAME_TYPE_ENUM 文档。
PrincipalContext(ContextType)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
例外
在使用应用程序目录上下文时，必须指定名称或容器。
contextType 参数不包含有效的 ContextType 枚举值。
适用于
PrincipalContext(ContextType, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型和名称初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
例外
在 contextType 参数中指定 ApplicationDirectory 时，必须指定名称。
contextType 参数不包含有效的 ContextType 枚举值。
适用于
PrincipalContext(ContextType, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型、名称和容器初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
- container
- String
存储区上要用作上下文的根的容器。 所有查询都在此根下执行，并且所有插入都在此容器中执行。
对于 Domain 和 ApplicationDirectory 上下文类型，此参数是容器对象的可分辨名称。
对于 Machine 上下文类型，此参数必须设置为 null。
例外
在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。
在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。
contextType 参数不包含有效的 ContextType 枚举值。
注解
InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。
适用于
PrincipalContext(ContextType, String, String, ContextOptions)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型、名称、容器和上下文选项初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
- container
- String
存储区上要用作上下文的根的容器。 所有查询都在此根下执行，并且所有插入都在此容器中执行。
对于 Domain 和 ApplicationDirectory 上下文类型，此参数是容器对象的可分辨名称。
对于 Machine 上下文类型，此参数必须设置为 null。
- options
- ContextOptions
一个或多个 ContextOptions 枚举值的组合，这些枚举值指定用于绑定到服务器的选项。 如果此参数为 null，则默认选项为 ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing。
例外
在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。
在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。
contextType 参数不包含有效的 ContextType 枚举值。
options 参数不包含有效 ContextOptions 枚举值的组合。
注解
InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。
适用于
PrincipalContext(ContextType, String, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型、名称、用户名和密码初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
- userName
- String
用于连接到存储区的用户名。 如果 userName 和 password 参数都为 null，则使用当前进程的凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
- password
- String
用于连接到存储区的密码。 如果 userName 和 password 参数都为 null，则使用当前进程的凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
例外
username 和 password 参数必须为 null 或包含值。
在 contextType 参数中指定 ApplicationDirectory 时，必须指定名称。
contextType 参数不包含有效的 ContextType 枚举值。
适用于
PrincipalContext(ContextType, String, String, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型、名称、容器、用户名和密码初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
- container
- String
存储区上要用作上下文的根的容器。 所有查询都在此根下执行，并且所有插入都在此容器中执行。
对于 Domain 和 ApplicationDirectory 上下文类型，此参数是容器对象的可分辨名称。
对于 Machine 上下文类型，此参数必须设置为 null。
- userName
- String
用于连接到存储区的用户名。 如果 userName 和 password 参数都为 null，则使用当前主体的默认凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
- password
- String
用于连接到存储区的密码。 如果 userName 和 password 参数都为 null，则使用当前主体的默认凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
例外
username 和 password 参数必须为 null 或包含值。
在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。
在 name 参数中指定 ApplicationDirectory 时，必须指定 container 或 contextType。
contextType 参数不包含有效的 ContextType 枚举值。
注解
InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。
适用于
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Source:
- Context.cs
- Source:
- Context.cs
- Source:
- Context.cs
使用指定的上下文类型、名称、容器、上下文选项、用户名和密码初始化 PrincipalContext 类的新实例。
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)参数
- contextType
- ContextType
一个 ContextType 枚举值，指定主体上下文的存储区的类型。
- name
- String
用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。
如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。
- container
- String
存储区上要用作上下文的根的容器。 所有查询都在此根下执行，并且所有插入都在此容器中执行。
对于 Domain 和 ApplicationDirectory 上下文类型，此参数是容器对象的可分辨名称。
对于 Machine 上下文类型，此参数必须设置为 null。
- options
- ContextOptions
一个或多个 ContextOptions 枚举值的组合，这些枚举值指定用于绑定到服务器的选项。 如果此参数为 null，则默认选项为 ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing。
- userName
- String
用于连接到存储区的用户名。 如果 userName 和 password 参数都为 null，则使用当前主体的默认凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
- password
- String
用于连接到存储区的密码。 如果 userName 和 password 参数都为 null，则使用当前主体的默认凭据。 否则，userName 和 password 都不可以为 null，并使用这两个参数指定的凭据来连接到存储区。
例外
username 和 password 参数必须为 null 或包含值。
在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。
在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。
contextType 参数不包含有效的 ContextType 枚举值。
options 参数不包含有效 ContextOptions 枚举值的组合。
注解
InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则可能会在连接到服务器的后续目录操作调用中引发 。 容器定义为其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）的对象。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈