SqlCommand.CommandText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースで実行する 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, setPublic 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
詳細については、「パラメーターの 構成」を参照してください。