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 方法會寫入一個連接到應用程式的設定檔。 連線字串與提供者名稱會寫入根據參數命名name的 connectionStrings 元素（ASP.NET 設定架構）配置元素。 Name參數的connection性質被忽略。

該方法的實作 ConfigureConnection 應拋出以下例外。

例外狀況	Reason
ArgumentException	應用程式的設定檔中存在重複名稱。
FileNotFoundException， ， UnauthorizedAccessException或其他適當的檔案輸入輸出例外。	應用程式的設定檔無法更新。 你的 ConfigureConnection 方法實作應該會拋出適當的例外。
CheckoutException	應用程式的設定檔無法從原始碼控制系統借出。

考慮使用命名空間中的 System.Configuration 配置管理 API 來讀寫應用程式的設定檔。 該 ConnectionStringsSection 類別會讀取並寫入 connectionStrings 元素（ASP.NET 設定結構） 的設定元素。