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。