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必要があります。