OracleCommand.CommandText プロパティ

.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

C#

public override string CommandText { get;
 set; }

C++

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

J#

/** @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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleCommand クラス
OracleCommand メンバ
System.Data.OracleClient 名前空間
その他の技術情報
コマンドの使用