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.