OleDbCommand.CommandText プロパティ

定義

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

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Public Property CommandText As String

プロパティ値

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

実装

属性

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

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

注釈

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

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

現在の接続が Connection実行操作またはフェッチ操作を実行している場合、、 CommandType、および CommandText の各プロパティを設定することはできません。

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

SELECT * FROM Customers WHERE CustomerID = ?

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

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

適用対象

こちらもご覧ください