IDataEnvironment.ConfigureConnection 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將連接字串寫入應用程式組態檔。
public:
System::ComponentModel::Design::Data::DesignerDataConnection ^ ConfigureConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::String ^ name);public System.ComponentModel.Design.Data.DesignerDataConnection ConfigureConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, string name);abstract member ConfigureConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection * string -> System.ComponentModel.Design.Data.DesignerDataConnectionPublic Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection參數
- owner
- IWin32Window
對話方塊的父視窗 (如果有的話)。
- connection
- DesignerDataConnection
DesignerDataConnection 物件，包含所要儲存的連接資料。
- name
- String
新連接組態項目的名稱。
傳回
DesignerDataConnection 物件，包含已儲存的連接資料，並且 Name 屬性設為 name，而 IsConfigured 屬性設為 true。
備註
方法 ConfigureConnection 會寫入應用程式的組態檔連線。 連接字串和提供者名稱會寫入 connectionStrings 元素， (ASP.NET 設定架構) 根據 參數命名的 name 組態專案。 忽略 Name 參數的 connection 屬性。
方法的實作 ConfigureConnection 應該會擲回下列例外狀況。
| 例外狀況 | 原因 |
|---|---|
| ArgumentException | 應用程式組態檔中有重複的名稱。 |
| FileNotFoundException、 UnauthorizedAccessException、 或其他適當的檔案 IO 例外狀況。 | 無法更新應用程式的組態檔。 您的 ConfigureConnection 方法實作應該擲回適當的例外狀況。 |
| CheckoutException | 無法從原始檔控制系統取出應用程式的組態檔。 |
請考慮使用 命名空間中的 System.Configuration 組態管理 API 來讀取和寫入應用程式的組態檔。 類別 ConnectionStringsSection 會讀取和寫入 connectionStrings 元素 (ASP.NET 設定架構) 組態專案。
