OleDbCommand.CommandText プロパティ

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

OleDbCommand.CommandText プロパティ

データ ソースで実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 CommandText As String

Visual Basic (使用法)

Dim instance As OleDbCommand
Dim value As String

value = instance.CommandText

instance.CommandText = value

C#

public override string CommandText { get;
 set; }

C++

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

J#

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

JScript

public override function get
 CommandText () : String

public override function set
 CommandText (value : String)

プロパティ値
実行する SQL ステートメントまたはストアド プロシージャ。既定値は空の文字列です。

解説

CommandType プロパティを StoredProcedure に設定したときは、CommandType プロパティをストアド プロシージャ名に設定する必要があります。ストアド プロシージャ名に特殊文字が含まれる場合、ユーザーはエスケープ文字の構文を使用する必要があります。Execute メソッドの 1 つを呼び出すと、コマンドがこのストアド プロシージャを実行します。

CommandType を TableDirect に設定した場合は、アクセスするテーブルの名前を CommandType プロパティに設定する必要があります。テーブル名に特殊文字が含まれている場合は、エスケープ文字構文を使用する必要があります。Execute メソッドの 1 つを呼び出すと、指定したテーブルのすべての行および列が返されます。

現在の接続で実行またはフェッチ操作が実行中の場合は、Connection、CommandType、および CommandText プロパティは設定できません。

CommandType を Text に設定した場合、OLE DB .NET プロバイダでは、OleDbCommand が呼び出す SQL ステートメントまたはストアド プロシージャにパラメータを渡すための名前付きパラメータを利用できません。この場合は、疑問符 (?) プレースホルダを使用する必要があります。次に例を示します。

SELECT * FROM Customers WHERE CustomerID = ?

したがって、パラメータの疑問符プレースホルダの位置と、OleDbParameter オブジェクトを OleDbParameterCollection に追加する順序とを、正しく対応させる必要があります。

詳細については、「コマンドによるストアド プロシージャの使用」を参照してください。

使用例

OleDbCommand を作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

C#

public void CreateMyOleDbCommand() 
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}

プラットフォーム

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、1.1、1.0

参照

関連項目
OleDbCommand クラス
OleDbCommand メンバ
System.Data.OleDb 名前空間
その他の技術情報
コマンドの使用