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 объектом , это означает, что пользователь хочет изменить существующее подключение.

Ваша среда разработки отвечает за создание подключения к данным, добавление подключения в глобальный список подключений или в файл конфигурации веб-приложения и добавление нового подключения к свойству Connections .

Новое подключение должно содержать сведения, необходимые приложению для создания подключения к данным во время выполнения. Если необходимо использовать подключение к данным в среде разработки GetDesignTimeConnection , используйте метод , чтобы вернуть DbConnection объект, который будет подключаться к хранилищу данных из среды разработки.

Если пользователь решает отменить процесс создания нового подключения, BuildConnection метод должен вернуть .null