IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) 方法

定義

命名空間:

System.ComponentModel.Design.Data

組件:

System.Design.dll

使用設計工具的新連接使用者介面，建立新資料連接或編輯現有的連接。

public:
 System::ComponentModel::Design::Data::DesignerDataConnection ^ BuildConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ initialConnection);

public System.ComponentModel.Design.Data.DesignerDataConnection BuildConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection initialConnection);

abstract member BuildConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection -> System.ComponentModel.Design.Data.DesignerDataConnection

Public Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnection

參數

owner

IWin32Window

連接對話方塊的父視窗。

initialConnection

DesignerDataConnection

要編輯的連接 (如果有的話)。 若要建立新連接，initialConnection 應該是 null。

傳回

DesignerDataConnection

新的或編輯過的 DesignerDataConnection 物件，如果使用者取消，則為 null。

備註

BuildConnection使用 方法來啟用設計環境的使用者介面，以建立或編輯數據連線。 initialConnection如果 參數為 null，表示使用者想要建立新的連線。 initialConnection如果 參數是 DesignerDataConnection 物件，表示使用者想要編輯現有的連接。

您的設計環境負責建立數據連線、將連線新增至連線的全域清單或 Web 應用程式的組態檔，以及將新連線新增至 Connections 屬性。

新的連接應該包含應用程式在運行時間建立數據連線所需的資訊。 如果您需要在設計環境中使用數據連接，請使用 GetDesignTimeConnection 方法傳回 DbConnection 物件，該物件會從設計環境連接到數據存放區。

如果使用者選擇取消新的連線建立程式，方法 BuildConnection 應該會傳回 null。