IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) 方法

定义

使用设计工具的新连接用户界面创建新的数据连接或编辑现有连接。

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 对象,如果用户取消操作,则为 null

注解

BuildConnection使用 方法激活设计环境的用户界面,以便创建或编辑数据连接。 initialConnection如果 参数为 null,则表示用户想要创建新连接。 initialConnection如果 参数是 对象DesignerDataConnection,则表示用户想要编辑现有连接。

设计环境负责创建数据连接,将连接添加到全局连接列表或 Web 应用程序的配置文件,并将新连接添加到 Connections 属性。

新连接应包含应用程序在运行时创建数据连接所需的信息。 如果需要在设计环境中使用数据连接,请使用 GetDesignTimeConnection 方法返回将从 DbConnection 设计环境连接到数据存储的对象。

如果用户选择取消新连接创建过程,该方法 BuildConnection 应返回 null

适用于