語言

PrincipalContext 建構函式

定義

初始化 PrincipalContext 類別的新執行個體。

多載

名稱 Description
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 沒有容器,當應用程式嘗試在建構子中指定容器時,會拋出 a ArgumentException 。

在每個以使用者名稱為參數的建構子版本中,字 userName 串可以有各種不同的格式。 支援的三種名稱格式分別是 Nt4Name、UserPrincipalName 和 SamAccountName。 欲了解更多名稱格式資訊,請參閱 ADS_NAME_TYPE_ENUM文件。

PrincipalContext(ContextType)

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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一個列舉值,指定主要上下文的儲存類型。

例外狀況

使用應用程式目錄上下文時,必須指定名稱或容器。

該 contextType 參數不包含有效的 ContextType 列舉值。

適用於

PrincipalContext(ContextType, String)

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

例外狀況

當 ApplicationDirectory 參數中指定 contextType 時,必須指定名稱。

該 contextType 參數不包含有效的 ContextType 列舉值。

適用於

PrincipalContext(ContextType, String, String)

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

container
String

儲存在儲存裝置上的容器作為上下文的根節點。 所有查詢皆在此根節點下執行,所有插入皆在此容器中執行。

對於 Domain 和 ApplicationDirectory 上下文類型,這個參數是容器物件的區別名稱。

對於 Machine 上下文型別,此參數必須設為 null。

例外狀況

當 Machine 上下文類型在參數中 contextType 被指定時,容器就無法被指定。

當 ApplicationDirectory 參數中指定 contextType 時,必須指定名稱或容器。

該 contextType 參數不包含有效的 ContextType 列舉值。

備註

若主上下文指定的InvalidOperationException容器不是有效的容器,後續連接伺服器的目錄操作呼叫中,可能會拋出這些指令Domain。 容器被定義為其結構類別中可能的 Inferiors 屬性中包含主要類別(使用者、群組或電腦)的物件。

適用於

PrincipalContext(ContextType, String, String, ContextOptions)

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

container
String

儲存在儲存裝置上的容器作為上下文的根節點。 所有查詢皆在此根節點下執行,所有插入皆在此容器中執行。

對於 Domain 和 ApplicationDirectory 上下文類型,這個參數是容器物件的區別名稱。

對於 Machine 上下文型別,此參數必須設為 null。

options
ContextOptions

一個或多個 ContextOptions 列舉值的組合,指定用於綁定伺服器的選項。 若此參數為 null,預設選項為 ContextOptions.Negotiate |ContextOptions.Signing |情境選項。封印。

例外狀況

當 Machine 上下文類型在參數中 contextType 被指定時,容器就無法被指定。

當 ApplicationDirectory 參數中指定 contextType 時,必須指定名稱或容器。

該 contextType 參數不包含有效的 ContextType 列舉值。

該 options 參數不包含有效 ContextOptions 列舉值的組合。

備註

若主上下文指定的InvalidOperationException容器不是有效的容器,後續連接伺服器的目錄操作呼叫中,可能會拋出這些指令Domain。 容器被定義為其結構類別中可能的 Inferiors 屬性中包含主要類別(使用者、群組或電腦)的物件。

適用於

PrincipalContext(ContextType, String, String, String)

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

userName
String

用戶名是用來連接商店的。 若 和 userNamepassword 參數皆 null為 ,則使用當前程序的憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

password
String

用來連接商店的密碼。 若 和 userNamepassword 參數皆 null為 ,則使用當前程序的憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

例外狀況

userName和password參數必須是null或包含一個值。

當 ApplicationDirectory 參數中指定 contextType 時,必須指定名稱。

該 contextType 參數不包含有效的 ContextType 列舉值。

適用於

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

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

container
String

儲存在儲存裝置上的容器作為上下文的根節點。 所有查詢皆在此根節點下執行,所有插入皆在此容器中執行。

對於 Domain 和 ApplicationDirectory 上下文類型,這個參數是容器物件的區別名稱。

對於 Machine 上下文型別,此參數必須設為 null。

userName
String

用戶名是用來連接商店的。 若 和 userNamepassword 參數皆 null為 ,則使用當前主體的預設憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

password
String

用來連接商店的密碼。 若 和 userNamepassword 參數皆 null為 ,則使用當前主體的預設憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

例外狀況

userName和password參數必須是null或包含一個值。

當 Machine 上下文類型在參數中 contextType 被指定時,容器就無法被指定。

當name參數中指定container時,必須指定 A ApplicationDirectory 或contextType。

該 contextType 參數不包含有效的 ContextType 列舉值。

備註

若主上下文指定的InvalidOperationException容器不是有效的容器,後續連接伺服器的目錄操作呼叫中,可能會拋出這些指令Domain。 容器被定義為其結構類別中可能的 Inferiors 屬性中包含主要類別(使用者、群組或電腦)的物件。

適用於

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

來源:
Context.cs
來源:
Context.cs
來源:
Context.cs
來源:
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 例的埠名。

若名稱為 null 上下文 Domain 類型,該上下文為執行緒所屬使用者主體域的網域控制器。 如果名稱是 null 上下文 Machine 型別的,則是本地機器名稱。 此參數不能用於nullApplicationDirectory上下文類型。

container
String

儲存在儲存裝置上的容器作為上下文的根節點。 所有查詢皆在此根節點下執行,所有插入皆在此容器中執行。

對於 Domain 和 ApplicationDirectory 上下文類型,這個參數是容器物件的區別名稱。

對於 Machine 上下文型別,此參數必須設為 null。

options
ContextOptions

一個或多個 ContextOptions 列舉的組合會決定綁定到伺服器的選項值。 若此參數為 null,預設選項為 ContextOptions.Negotiate |ContextOptions.Signing |情境選項。封印。

userName
String

用戶名是用來連接商店的。 若 和 userNamepassword 參數皆 null為 ,則使用當前主體的預設憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

password
String

用來連接商店的密碼。 若 和 userNamepassword 參數皆 null為 ,則使用當前主體的預設憑證。 否則, userName 和 password 都必須非空,且使用它們指定的憑證連接商店。

例外狀況

userName和password參數必須是null或包含一個值。

當 Machine 上下文類型在參數中 contextType 被指定時,容器就無法被指定。

當 ApplicationDirectory 參數中指定 contextType 時,必須指定名稱或容器。

該 contextType 參數不包含有效的 ContextType 列舉值。

該 options 參數不包含有效 ContextOptions 列舉值的組合。

備註

若主上下文指定的InvalidOperationException容器不是有效的容器,後續連接伺服器的目錄操作呼叫中,可能會拋出這些指令Domain。 容器被定義為其結構類別中可能的 Inferiors 屬性中包含主要類別(使用者、群組或電腦)的物件。

適用於