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 メソッドは、アプリケーションの構成ファイルへの接続を書き込みます。 接続文字列とプロバイダー名は、name パラメーターに従ってconnectionStrings 構成要素に書き込まれます。 Name パラメーターの connection プロパティは無視されます。

ConfigureConnection メソッドの実装では、次の例外がスローされます。

例外 理由
ArgumentException アプリケーションの構成ファイルに重複する名前が存在します。
FileNotFoundException、 UnauthorizedAccessException、またはその他の適切なファイル IO 例外。 アプリケーションの構成ファイルを更新できません。 ConfigureConnection メソッドの実装では、適切な例外をスローする必要があります。
CheckoutException アプリケーションの構成ファイルをソース管理システムからチェックアウトすることはできません。

System.Configuration名前空間の構成管理 API を使用して、アプリケーションの構成ファイルを読み書きすることを検討してください。 ConnectionStringsSection クラスは、connectionStrings構成要素の読み取りと書き込みを行います。

適用対象