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

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

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

OdbcParameter クラス

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As OdbcParameter

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

C++

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

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

JScript

public final class OdbcParameter 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 = 比較を使用します。

使用例

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

Visual Basic

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

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New
 OdbcDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OdbcType.VarChar, 80).Value
 = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OdbcType.Int).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

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

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OdbcType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OdbcType.Int).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;
}