OdbcParameter-Klasse

Stellt einen Parameter für einen OdbcCommand und optional dessen Zuordnung zu einer DataColumn dar. Die Klasse kann nicht geerbt werden.

Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public NotInheritable Class OdbcParameter
    Inherits DbParameter
    Implements ICloneable, IDbDataParameter, IDataParameter
'Usage
Dim instance As OdbcParameter

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

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

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

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

Hinweise

Bei Parameternamen wird die Groß- und Kleinschreibung nicht berücksichtigt.

Wenn Sie eine Oracle-Datenbank mit dem Microsoft OLE DB-Anbieter für Oracle (MSDAORA) und dem ODBC.NET Framework-Datenanbieter abfragen und Sie dabei die LIKE-Klausel zur Abfrage von Werten in Feldern mit fester Länge verwenden, werden möglicherweise nicht alle erwarteten Übereinstimmungen zurückgegeben. Der Grund hierfür ist, dass Oracle beim Abstimmen von Werten für Felder fester Länge in einer LIKE-Klausel die gesamte Länge der Zeichenfolge verwendet einschließlich aller angefügten nachstehenden Leerzeichen. Wenn eine Tabelle in einer Oracle-Datenbank z. B. ein Feld mit dem Namen "Field1" enthält, das als char(3) definiert ist, und Sie den Wert "a" in eine Zeile dieser Tabelle eingeben, kann der folgende Code die Zeile nicht zurückgeben.

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();

Die Ursache hierfür ist, dass Oracle den Spaltenwert als "a " (an "a" sind Leerzeichen angefügt, um die feste Länge von 3 zu erreichen) speichert. Dieser Wert kann von Oracle nicht als Übereinstimmung mit dem Wert von "a" bei einem LIKE-Vergleich von Feldern fester Länge ausgewertet werden.

Zum Beheben dieses Problems, fügen Sie als Platzhalterzeichen ein Prozentzeichen ("%") an den Parameterwert an ("a%") oder verwenden stattdessen einen SQL-=-Vergleich.

Beispiel

Im folgenden Beispiel werden über die OdbcParameterCollection im OdbcDataAdapter mehrere Instanzen von OdbcParameter erstellt. Mithilfe dieser Parameter werden Daten aus der Datenquelle ausgewählt und im DataSet platziert. In diesem Beispiel wird davon ausgegangen, dass mithilfe des entsprechenden Schemas, der entsprechenden Befehle sowie der entsprechenden Verbindung bereits ein DataSet und ein OdbcDataAdapter erstellt wurden.

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;
}

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameter
      System.Data.Odbc.OdbcParameter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OdbcParameter-Member
System.Data.Odbc-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen