OleDbCommand.CommandText プロパティ
データ ソースで実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。
Public Overridable Property CommandText As String Implements _ IDbCommand.CommandText
[C#]
public virtual string CommandText {get; set;}
[C++]
public: __property virtual String* get_CommandText();public: __property virtual void set_CommandText(String*);
[JScript]
public function get CommandText() : String;public function set CommandText(String);
プロパティ値
実行する SQL ステートメントまたはストアド プロシージャ。既定値は空の文字列です。
実装
解説
CommandType プロパティを StoredProcedure に設定したときは、 CommandText プロパティをストアド プロシージャ名に設定する必要があります。ストアド プロシージャ名に特殊文字が含まれる場合、ユーザーはエスケープ文字の構文を使用する必要があります。いずれかの Execute メソッドを呼び出すと、このストアド プロシージャがコマンドによって実行されます。
CommandType を TableDirect に設定した場合は、アクセスするテーブルの名前を CommandText プロパティに設定する必要があります。テーブル名に特殊文字が含まれている場合は、エスケープ文字構文を使用する必要があります。いずれかの Execute メソッドを呼び出すと、指定したすべてのテーブルのすべての行および列が返されます。
現在の接続で実行またはフェッチ操作が実行中の場合は、 Connection 、 CommandType 、および CommandText プロパティは設定できません。
CommandType を Text に設定した場合、OLE DB .NET プロバイダでは、 OleDbCommand が呼び出す SQL ステートメントまたはストアド プロシージャにパラメータを渡すための名前付きパラメータを利用できません。この場合は、疑問符 (?) プレースホルダを使用する必要があります。次に例を示します。
SELECT * FROM Customers WHERE CustomerID = ?
このため、パラメータの疑問符プレースホルダの位置と、 OleDbParameter オブジェクトを OleDbParameterCollection に追加する順序とを、正しく対応させる必要があります。
詳細については、「 コマンドによるストアド プロシージャの使用 」を参照してください。
使用例
[Visual Basic, C#, C++] OleDbCommand を作成し、そのプロパティの一部を設定する例を次に示します。
Public Sub CreateMyOleDbCommand()
Dim myCommand As New OleDbCommand()
myCommand.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
myCommand.CommandTimeout = 20
End Sub
[C#]
public void CreateMyOleDbCommand()
{
OleDbCommand myCommand = new OleDbCommand();
myCommand.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
myCommand.CommandTimeout = 20;
}
[C++]
public:
void CreateMyOleDbCommand()
{
OleDbCommand* myCommand = new OleDbCommand();
myCommand->CommandText = S"SELECT * FROM Categories ORDER BY CategoryID";
myCommand->CommandTimeout = 20;
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
OleDbCommand クラス | OleDbCommand メンバ | System.Data.OleDb 名前空間 | Connection | CommandTimeout | CommandType