PrincipalContext 构造函数

定义

命名空间:

System.DirectoryServices.AccountManagement

程序集:

System.DirectoryServices.AccountManagement.dll

包:

System.DirectoryServices.AccountManagement v8.0.0

初始化 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

使用指定的上下文类型初始化 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.PrincipalContext

Public Sub New (contextType As ContextType)

参数

contextType

ContextType

一个 ContextType 枚举值，指定主体上下文的存储区的类型。

例外

ArgumentException

在使用应用程序目录上下文时，必须指定名称或容器。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

PrincipalContext(ContextType, String)

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.PrincipalContext

Public Sub New (contextType As ContextType, name As String)

参数

contextType

ContextType

一个 ContextType 枚举值，指定主体上下文的存储区的类型。

name

String

用于 Domain 上下文类型的域或服务器的名称、用于 Machine 上下文类型的计算机名称或承载 ApplicationDirectory 实例的服务器和端口的名称。

如果 Domain 上下文类型的名称为 null，则此上下文是运行该线程的用户主体的域的域控制器。 如果 Machine 上下文类型的名称为 null，则此名称是本地计算机名称。 对于 ApplicationDirectory 上下文类型，此参数不能为 null。

例外

ArgumentException

在 contextType 参数中指定 ApplicationDirectory 时，必须指定名称。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

PrincipalContext(ContextType, String, String)

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.PrincipalContext

Public 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。

例外

ArgumentException

在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。

在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

注解

InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。

PrincipalContext(ContextType, String, String, ContextOptions)

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.PrincipalContext

Public 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。

例外

ArgumentException

在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。

在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

options 参数不包含有效 ContextOptions 枚举值的组合。

注解

InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。

PrincipalContext(ContextType, String, String, String)

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.PrincipalContext

Public 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，并使用这两个参数指定的凭据来连接到存储区。

例外

ArgumentException

username 和 password 参数必须为 null 或包含值。

在 contextType 参数中指定 ApplicationDirectory 时，必须指定名称。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

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

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.PrincipalContext

Public 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，并使用这两个参数指定的凭据来连接到存储区。

例外

ArgumentException

username 和 password 参数必须为 null 或包含值。

在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。

在 name 参数中指定 ApplicationDirectory 时，必须指定 container 或 contextType。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

注解

InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则在连接到服务器的后续目录操作调用中可能会引发 。 容器定义为一个对象，其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）。

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

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.PrincipalContext

Public 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，并使用这两个参数指定的凭据来连接到存储区。

例外

ArgumentException

username 和 password 参数必须为 null 或包含值。

在 contextType 参数中指定 Machine 上下文类型时，不能指定容器。

在 contextType 参数中指定 ApplicationDirectory 时，必须指定 name 或 container。

InvalidEnumArgumentException

contextType 参数不包含有效的 ContextType 枚举值。

options 参数不包含有效 ContextOptions 枚举值的组合。

注解

InvalidOperationException如果为Domain主体上下文指定的容器不是有效的容器，则可能会在连接到服务器的后续目录操作调用中引发 。 容器定义为其架构类在其可能的Inferiors 属性中具有主体类（用户、组或计算机）的对象。