IDataEnvironment.ConfigureConnection 方法

定義

命名空間:

System.ComponentModel.Design.Data

組件:

System.Design.dll

將連接字串寫入應用程式組態檔。

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

Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

參數

owner

IWin32Window

對話方塊的父視窗 (如果有的話)。

connection

DesignerDataConnection

DesignerDataConnection 物件，包含所要儲存的連接資料。

name

String

新連接組態項目的名稱。

傳回

DesignerDataConnection

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 設定架構) 組態專案。