IDataEnvironment.BuildQuery メソッド

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

IDataEnvironment.BuildQuery メソッド

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

SQL クエリ文字列を作成するダイアログを起動します。

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

Visual Basic (宣言)

Function BuildQuery ( _
    owner As IWin32Window, _
    connection As DesignerDataConnection, _
    mode As QueryBuilderMode, _
    initialQueryText As String _
) As String

Visual Basic (使用法)

Dim instance As IDataEnvironment
Dim owner As IWin32Window
Dim connection As DesignerDataConnection
Dim mode As QueryBuilderMode
Dim initialQueryText As String
Dim returnValue As String

returnValue = instance.BuildQuery(owner, connection, mode, initialQueryText)

C#

string BuildQuery (
    IWin32Window owner,
    DesignerDataConnection connection,
    QueryBuilderMode mode,
    string initialQueryText
)

C++

String^ BuildQuery (
    IWin32Window^ owner, 
    DesignerDataConnection^ connection, 
    QueryBuilderMode mode, 
    String^ initialQueryText
)

J#

String BuildQuery (
    IWin32Window owner, 
    DesignerDataConnection connection, 
    QueryBuilderMode mode, 
    String initialQueryText
)

JScript

function BuildQuery (
    owner : IWin32Window, 
    connection : DesignerDataConnection, 
    mode : QueryBuilderMode, 
    initialQueryText : String
) : String

パラメータ

owner

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

connection

クエリで使用するデータ接続。

mode

QueryBuilderMode 値の 1 つ。

initialQueryText

クエリの初期値。または、新しいクエリを作成する場合は Empty。

戻り値
SQL クエリが格納された文字列。ユーザーがキャンセルした場合は null 参照 (Visual Basic では Nothing)。

解説

BuildQuery メソッドは、SQL クエリ文字列の編集または作成のための、デザイン環境の UI を起動します。initialQueryText パラメータが Empty の場合は、ユーザーによって新しいクエリが作成されることを示します。initialQueryText パラメータに文字列が含まれる場合は、ユーザーによって既存のクエリが編集されることを示します。

mode パラメータはユーザーによって作成するクエリの種類を示します。SELECT、UPDATE、INSERT、または DELETE のいずれかが選択されます。ユーザー インターフェイスで mode パラメータを使用して、目的のクエリの種類にユーザー インターフェイスを構成したり、ユーザーが目的のクエリの種類でだけ有効な SQL ステートメントを使用するように制限したりできます。また、目的の種類に対してクエリを検証することもできます。

.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 名前空間