SqlCommand.CommandText プロパティ

定義

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

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Overrides Property CommandText As String

プロパティ値

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

次の例では、 を SqlCommand 作成し、そのプロパティの一部を設定します。

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

    public void CreateCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
    // </Snippet1>

}

注釈

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

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

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

詳細については、「パラメーターの 構成」を参照してください。

適用対象