OleDbCommand.CommandType プロパティ

CommandText プロパティの解釈方法を示す値を取得または設定します。

Public Overridable Property CommandType As CommandType  Implements _   IDbCommand.CommandType
[C#]
public virtual CommandType CommandType {get; set;}
[C++]
public: __property virtual CommandType get_CommandType();public: __property virtual void set_CommandType(CommandType);
[JScript]
public function get CommandType() : CommandType;public function set CommandType(CommandType);

プロパティ値

CommandType 値の 1 つ。既定値は Text です。

実装

IDbCommand.CommandType

例外

例外の種類	条件
ArgumentException	値が有効な CommandType ではありません。

解説

CommandType プロパティを StoredProcedure に設定したときは、 CommandText プロパティをストアド プロシージャ名に設定する必要があります。いずれかの Execute メソッドを呼び出すと、このストアド プロシージャがコマンドによって実行されます。

現在の接続で実行またはフェッチ操作が実行中の場合は、 Connection 、 CommandType 、および CommandText プロパティは設定できません。

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

SELECT * FROM Customers WHERE CustomerID = ?

このため、パラメータの疑問符プレースホルダの位置と、 OleDbParameter オブジェクトを OleDbParameterCollection に追加する順序とを、正しく対応させる必要があります。詳細については、「 コマンドによるストアド プロシージャの使用 」を参照してください。

使用例

[Visual Basic, C#, C++] OleDbCommand 派生クラスのインスタンスを作成し、そのプロパティの一部を設定する例を次に示します。

 
Public Sub CreateMyOleDbCommand()
    Dim myCommand As New OleDbCommand()
    myCommand.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    myCommand.CommandType = CommandType.Text
End Sub

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

[C++] 
public:
 void CreateMyOleDbCommand() 
 {
    OleDbCommand* myCommand = new OleDbCommand();
    myCommand->CommandText = S"SELECT * FROM Categories ORDER BY CategoryID";
    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 ファミリ

参照

OleDbCommand クラス | OleDbCommand メンバ | System.Data.OleDb 名前空間 | CommandText | UpdatedRowSource