OracleCommand.CommandText プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

OracleCommand.CommandText プロパティ

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

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 CommandText As String

Visual Basic (使用法)

Dim instance As OracleCommand
Dim value As String

value = instance.CommandText

instance.CommandText = value

public override string CommandText { get;
 set; }

C++

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

JScript

public override function get
 CommandText () : String

public override function set
 CommandText (value : String)

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

解説

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

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

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

CommandType.Text の OracleCommand で呼び出される SQL ステートメントで名前付きパラメータを使用する場合は、パラメータ名の前にコロン (:) を付ける必要があります。ただし、ストアドプロシージャア、またはコードの別の場所で名前付きパラメータを参照する場合 (Parameters プロパティに OracleParameter オブジェクトを追加する場合など) は、名前付きパラメータの前にコロン (:) を付けないでください。.NET Framework Oracle 用データプロバイダは自動的にコロンを付与します。

使用例

OracleCommand を作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

Public Sub CreateOracleCommand()
    Dim command As New OracleCommand()
    command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo"
    command.CommandType = CommandType.Text
End Sub

public void CreateOracleCommand() 
{
   OracleCommand command = new OracleCommand();
   command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo";
   command.CommandType = CommandType.Text;
}