Поделиться через


IDataEnvironment.ConfigureConnection Метод

Определение

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

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,содержащий сохраненные данные соединения со свойством 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).

Применяется к