PrincipalContext 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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 屬性中包含主要類別(使用者、群組或電腦)的物件。