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 元素 (ASP.NET“设置架构”) 配置元素（根据 name 参数命名）。 参数 Name 的 connection 属性将被忽略。

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

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

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