IDataEnvironment.ConfigureConnection Метод

Определение

Пространство имен:

System.ComponentModel.Design.Data

Сборка:

System.Design.dll

Записывает строку подключения в файле конфигурации приложения.

public:
 System::ComponentModel::Design::Data::DesignerDataConnection ^ ConfigureConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::String ^ name);

public System.ComponentModel.Design.Data.DesignerDataConnection ConfigureConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, string name);

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

Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

Параметры

owner

IWin32Window

Родительское окно для диалогового окна подключения (если имеется).

connection

DesignerDataConnection

Объект DesignerDataConnection,содержащий данные подключения для сохранения.

name

String

Имя записи конфигурации нового подключения.

Возвращаемое значение

DesignerDataConnection

Объект DesignerDataConnection,содержащий сохраненные данные соединения со свойством Name значение которого name, свойством IsConfigured значение которого true.

Комментарии

Метод ConfigureConnection записывает подключение в файл конфигурации приложения. Имя строка подключения и поставщика записываются в элемент конфигурации connectionStrings Element (ASP.NET Settings Schema) с именем в соответствии с параметром name . Свойство Nameconnection параметра игнорируется.

ConfigureConnection Реализации метода должны вызывать следующие исключения.

Исключение	Причина
ArgumentException	В файле конфигурации приложения существует повторяющееся имя.
FileNotFoundException, UnauthorizedAccessExceptionили другое соответствующее исключение ввода-вывода файла.	Файл конфигурации приложения не может быть обновлен. Реализация ConfigureConnection метода должна вызвать соответствующее исключение.
CheckoutException	Файл конфигурации приложения не может быть извлечен из системы управления версиями.

Рассмотрите возможность использования API управления конфигурацией в System.Configuration пространстве имен для чтения и записи файла конфигурации приложения. Класс ConnectionStringsSection считывает и записывает элемент конфигурации connectionStrings Element (ASP.NET Settings Schema).