IDataEnvironment.BuildConnection メソッド

.NET Framework クラス ライブラリ リファレンス

IDataEnvironment.BuildConnection メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.ComponentModel.Design.Data
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As IDataEnvironment
Dim owner As IWin32Window
Dim initialConnection As DesignerDataConnection
Dim returnValue As DesignerDataConnection

returnValue = instance.BuildConnection(owner, initialConnection)

C#

DesignerDataConnection BuildConnection (
    IWin32Window owner,
    DesignerDataConnection initialConnection
)

C++

DesignerDataConnection^ BuildConnection (
    IWin32Window^ owner, 
    DesignerDataConnection^ initialConnection
)

J#

DesignerDataConnection BuildConnection (
    IWin32Window owner, 
    DesignerDataConnection initialConnection
)

JScript

function BuildConnection (
    owner : IWin32Window, 
    initialConnection : DesignerDataConnection
) : DesignerDataConnection

パラメータ

owner

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

initialConnection

編集対象の接続 (存在する場合)。新しい接続を作成するには、initialConnection が null 参照 (Visual Basic では Nothing) である必要があります。

戻り値
新しい (または編集された) DesignerDataConnection オブジェクト。ユーザーがキャンセルした場合は null 参照 (Visual Basic では Nothing)。

解説

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

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

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

ユーザーが新しい接続の作成処理のキャンセルを選択した場合、BuildConnection メソッドは null 参照 (Visual Basic では Nothing) を返します。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IDataEnvironment インターフェイス
IDataEnvironment メンバ
System.ComponentModel.Design.Data 名前空間