OracleParameter クラスとは何？わかりやすく解説 Weblio辞書

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

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

OracleParameter クラス

OracleCommand のパラメータと、オプションとして DataColumn に対するマップを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 OracleParameter
    Inherits DbParameter
    Implements ICloneable, IDbDataParameter, IDataParameter

Visual Basic (使用法)

Dim instance As OracleParameter

public sealed class OracleParameter : DbParameter,
 ICloneable, IDbDataParameter, IDataParameter

C++

public ref class OracleParameter sealed : public
 DbParameter, ICloneable, IDbDataParameter, IDataParameter

public final class OracleParameter extends
 DbParameter implements ICloneable, IDbDataParameter, 
    IDataParameter

JScript

public final class OracleParameter extends
 DbParameter implements ICloneable, IDbDataParameter, 
    IDataParameter

解説

パラメータ名では大文字と小文字が区別されません。

Microsoft OLE DB Provider for Oracle (MSDAORA) と ODBC .NET Framework データプロバイダを使用して Oracle データベースに対するクエリを実行する場合、LIKE 句を使用して固定長フィールドの値を問い合わせると、期待される一致したデータがすべて返されないことがあります。これは、Oracle によって LIKE 句の固定長フィールドの値との比較が行われるときに、末尾の空白を含めて、文字列の全長にわたって比較が行われるからです。たとえば、Oracle データベースのテーブルに char(3) として定義されている Field1 という名前のフィールドが存在し、そのテーブルの行の 1 つに "a" という値を入力した場合、次のコードでは該当する行が返されません。

Visual Basic

Dim queryString As String
 = "SELECT * FROM Table1 WHERE Field1 LIKE ?"
Dim command As OleDbCommand = New
 OleDbCommand(queryString, connection)
command.Parameters.Add("@p1", OleDbType.Char, 3).Value
 = "a"
Dim reader As OleDbDataReader = command.ExecuteReader()

string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE
 ?";
OleDbCommand command = new OleDbCommand(queryString, connection);
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a";
OleDbDataReader reader = command.ExecuteReader();

これは、Oracle では、3 の固定長に合わせるために "a" に続けて空白を埋めて、列値を "a " として格納しているからです。Oracle は、固定長フィールドの LIKE 比較において、これをパラメータ値 "a" と一致しているとは見なしません。

この問題を解決するには、パーセント ("%") ワイルドカード文字をパラメータ値 ("a%") に追加するか、または代わりに SQL = 比較を使用します。

使用例

OracleDataAdapter の OracleParameterCollection を使用して、OracleParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータを使用して、データベースからデータを選択し、DataSet にデータを格納します。この例は、DataSet および OracleDataAdapter が、正しいスキーマ、コマンド、および接続で既に作成されていることを前提にしています。

Visual Basic

Public Sub AddOracleParameters()
    ' ...
    ' create dataSet and adapter
    ' ...
adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar,
 80).Value = "Smith"
adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value
 = 7369
adapter.Fill(dataSet)
End Sub

public void AddOracleParameters() 
 {
 // ...
 // create dataSet and adapter
 // ...
   adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value
 = "Smith";
   adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value
 = 7369;
   adapter.Fill(dataSet);
 }