IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) メソッド

定義

名前空間:

System.ComponentModel.Design.Data

アセンブリ:

System.Design.dll

新しいデータ接続を作成するか、デザイン ツールの新しい接続ユーザー インターフェイスを使用して既存の接続を編集します。

public:
 System::ComponentModel::Design::Data::DesignerDataConnection ^ BuildConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ initialConnection);

public System.ComponentModel.Design.Data.DesignerDataConnection BuildConnection(System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection initialConnection);

abstract member BuildConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection -> System.ComponentModel.Design.Data.DesignerDataConnection

Public Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnection

パラメーター

owner

IWin32Window

接続ダイアログの親ウィンドウ。

initialConnection

DesignerDataConnection

編集する接続 (存在する場合)。 新しい接続を作成するには、 initialConnection を nullする必要があります。

戻り値

DesignerDataConnection

新しいオブジェクトまたは編集された DesignerDataConnection オブジェクト。ユーザーがキャンセルした場合は null 。

注釈

BuildConnectionメソッドを使用して、データ接続を作成または編集するためのデザイン環境のユーザー インターフェイスをアクティブにします。 initialConnection パラメーターがnull場合は、ユーザーが新しい接続を作成することを示します。 initialConnection パラメーターがDesignerDataConnection オブジェクトの場合は、ユーザーが既存の接続を編集することを示します。

設計環境では、データ接続の作成、接続のグローバル リストへの接続の追加、または Web アプリケーションの構成ファイルへの接続の追加、 Connections プロパティへの新しい接続の追加を行います。

新しい接続には、アプリケーションが実行時にデータ接続を作成するために必要な情報が含まれている必要があります。 デザイン環境でデータ接続を使用する必要がある場合は、 GetDesignTimeConnection メソッドを使用して、デザイン環境からデータ ストアに接続する DbConnection オブジェクトを返します。

ユーザーが新しい接続作成プロセスをキャンセルすることを選択した場合、 BuildConnection メソッドは nullを返す必要があります。