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 属性设置为 nameIsConfigured 属性设置为 true

注解

方法 ConfigureConnection 将连接写入应用程序的配置文件。 连接字符串和提供程序名称将写入 connectionStrings 元素 (ASP.NET“设置架构”) 配置元素(根据 name 参数命名)。 参数 Nameconnection 属性将被忽略。

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

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

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

适用于