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 プロパティを true に設定した、保存された接続データを格納する IsConfigured オブジェクト。

注釈

メソッドは ConfigureConnection 、アプリケーションの構成ファイルへの接続を書き込みます。 接続文字列とプロバイダー名は、 パラメーターに従って という名前の connectionStrings 要素 (ASP.NET 設定スキーマ) 構成要素に name 書き込まれます。 Nameパラメーターの connection プロパティは無視されます。

メソッドの実装では、 ConfigureConnection 次の例外をスローする必要があります。

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

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