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

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

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

OracleCommand.Parameters プロパティ

OracleParameterCollection を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Parameters As OracleParameterCollection

Visual Basic (使用法)

Dim instance As OracleCommand
Dim value As OracleParameterCollection

value = instance.Parameters

public OracleParameterCollection Parameters { get;
 }

C++

public:
property OracleParameterCollection^ Parameters {
    OracleParameterCollection^ get ();
}

/** @property */
public OracleParameterCollection get_Parameters ()

JScript

public function get Parameters
 () : OracleParameterCollection

プロパティ値
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 を作成し、そのパラメータを表示する例を次に示します。この例では、OracleConnection、SQL SELECT ステートメントのクエリ文字列、および OracleParameter オブジェクトの配列がメソッドに渡されます。

Visual Basic

Public Sub CreateOracleCommand(ByVal
 connection As OracleConnection, _
ByVal queryString As String,
 ByVal prmArray() As OracleParameter)

    Dim command As New OracleCommand(queryString,
 connection)
    command.CommandText = _
        "SELECT * FROM Emp WHERE Job = :pJob AND Sal = :pSal"

    Dim j As Integer
    For j = 0 To prmArray.Length - 1
        command.Parameters.Add(prmArray(j))
    Next j

    Dim message As String
 = ""
    Dim i As Integer
    For i = 0 To command.Parameters.Count -
 1
        message += command.Parameters(i).ToString() + ControlChars.Cr
    Next i

    Console.WriteLine(message)

    Dim reader As OracleDataReader = command.ExecuteReader
    While reader.Read
        Console.WriteLine(reader.GetValue(0))
    End While

End Sub

public void CreateOracleCommand(OracleConnection
 connection,
    string queryString, OracleParameter[] myParamArray)
{

    OracleCommand command = new OracleCommand(queryString, connection);
    command.CommandText = 
        "SELECT * FROM Emp WHERE Job = :pJob AND Sal = :pSal";

    for (int j = 0; j < myParamArray.Length;
 j++)
        command.Parameters.Add(myParamArray[j]);

    string message = "";

    for (int i = 0; i < command.Parameters.Count;
 i++) 
        message += command.Parameters[i].ToString() + "\n";

    Console.WriteLine(message);

    using (OracleDataReader row = command.ExecuteReader()) 
    {
        while(row.Read()) 
        {
            Console.WriteLine(row.GetValue(0));
        }
    }
}