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

一个对象，其中包含已保存的连接数据，其属性设置为 <a0/>。

注解

该方法 ConfigureConnection 将连接写入到应用程序的配置文件。 连接字符串和提供程序名称将写入 connectionStrings 元素（ASP.NET 设置架构） 配置元素（根据 name 参数命名）。 忽略 Name 参数的属性 connection 。

方法的 ConfigureConnection 实现应引发以下异常。

Exception	原因
ArgumentException	应用程序配置文件中存在重复的名称。
FileNotFoundException、 UnauthorizedAccessException或其他适当的文件 IO 异常。	无法更新应用程序的配置文件。 方法 ConfigureConnection 实现应引发适当的异常。
CheckoutException	无法从源代码管理系统签出应用程序的配置文件。

请考虑使用命名空间中的 System.Configuration 配置管理 API 读取和写入应用程序的配置文件。 该 ConnectionStringsSection 类将读取和写入 connectionStrings 元素（ASP.NET 设置架构） 配置元素。