OleDbParameter クラス

定義

public ref class OleDbParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class OleDbParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameterConverter))]
public sealed class OleDbParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))]
public sealed class OleDbParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameterConverter))>]
type OleDbParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))>]
type OleDbParameter = class
    inherit DbParameter
    interface ICloneable
    interface IDbDataParameter
    interface IDataParameter

Public NotInheritable Class OleDbParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class OleDbParameter
Inherits DbParameter
Implements ICloneable

継承

Object

MarshalByRefObject

OleDbParameter

継承

Object

MarshalByRefObject

DbParameter

OleDbParameter

属性

TypeConverterAttribute

実装

IDataParameter IDbDataParameter ICloneable

例

次の例では、OleDbDataAdapter内のOleDbParameterCollection コレクションを通じてOleDbParameterの複数のインスタンスを作成します。 これらのパラメーターは、データ ソースからデータを選択し、 DataSetにデータを配置するために使用されます。 この例では、適切なスキーマ、コマンド、接続を使用して、 DataSet と OleDbDataAdapter が既に作成されていることを前提としています。

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

注釈

OLE DB.NET Framework Data Providerでは、名前付きパラメーターではなく疑問符 (?) でマークされた位置指定パラメーターが使用されます。

Microsoft OLE DB Provider for Oracle (MSDAORA) と OLE DB.NET Framework Data Providerを使用して Oracle データベースに対してクエリを実行する場合、固定長フィールドの値を照会するために LIKE 句を使用すると、予期される一致がすべて返されない場合があります。 理由は、Oracle が LIKE 句の固定長フィールドの値と一致する場合、埋め込みの末尾のスペースを含め、文字列の長さ全体と一致するということです。 たとえば、Oracle データベース内のテーブルに、 char(3)として定義されている "Field1" という名前のフィールドが含まれており、そのテーブルの行に値 "a" を入力した場合、次のコードは行を返しません。

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 が列の値を "a" (末尾のスペースを含む埋め込み "a") を固定フィールド長 3 に格納するためです。固定長フィールドの LIKE 比較の場合、Oracle は "a" のパラメーター値との一致として扱いません。

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

こちらもご覧ください

• コマンドの操作