OleDbCommand.CommandText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースで実行する 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
設定されている場合CommandType、 CommandType プロパティは、アクセスするテーブルの名前に設定する必要があります。 名前付きテーブルに特殊文字が含まれている場合、ユーザーはエスケープ文字構文を使用する必要があります。 いずれかのメソッドを呼び出すと、名前付きテーブルまたはテーブルのすべての行と列が Execute
返されます。
現在の接続が Connection実行操作またはフェッチ操作を実行している場合、、 CommandType、および CommandText の各プロパティを設定することはできません。
OLE DB.NET プロバイダーでは、 が にText
設定されている場合CommandType、SQL ステートメントまたは によってOleDbCommand呼び出されるストアド プロシージャにパラメーターを渡すための名前付きパラメーターはサポートされていません。 この場合は、疑問符 (?) プレースホルダーを使用する必要があります。 次に例を示します。
SELECT * FROM Customers WHERE CustomerID = ?
したがって、 にオブジェクトを追加OleDbParameterCollectionするOleDbParameter順序は、 パラメーターの疑問符プレースホルダーの位置に直接対応している必要があります。
詳細については、「 パラメーターとパラメーター データ型の構成」を参照してください。
適用対象
こちらもご覧ください
.NET