SqlCommand.CommandText プロパティ

データ ソースで実行する Transact-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);

プロパティ値

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

実装

IDbCommand.CommandText

解説

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

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

SELECT * FROM Customers WHERE CustomerID = @CustomerID

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

使用例

[Visual Basic, C#, C++] SqlCommand を作成し、そのプロパティの一部を設定する例を次に示します。

 
Public Sub CreateMySqlCommand()
    Dim myCommand As New SqlCommand()
    myCommand.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    myCommand.CommandTimeout = 15
    myCommand.CommandType = CommandType.Text
End Sub 'CreateMySqlCommand

[C#] 
public void CreateMySqlCommand() 
 {
    SqlCommand myCommand = new SqlCommand();
    myCommand.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    myCommand.CommandTimeout = 15;
    myCommand.CommandType = CommandType.Text;
 }

[C++] 
public:
void CreateMySqlCommand() 
 {
    SqlCommand* myCommand = new SqlCommand();
    myCommand->CommandText = S"SELECT * FROM Categories ORDER BY CategoryID";
    myCommand->CommandTimeout = 15;
    myCommand->CommandType = CommandType::Text;
 }

[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 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlCommand クラス | SqlCommand メンバ | System.Data.SqlClient 名前空間 | Connection | CommandTimeout | CommandType