OdbcParameter Klasse

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Quelle:

OdbcParameter.cs

Stellt einen Parameter für einen OdbcCommand und optional für seine Zuordnung zu einer DataColumn dar. Diese Klasse kann nicht vererbt werden.

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

public sealed class OdbcParameter : System.Data.Common.DbParameter, ICloneable

type OdbcParameter = class
    inherit DbParameter
    interface ICloneable
    interface IDataParameter
    interface IDbDataParameter

Public NotInheritable Class OdbcParameter
Inherits DbParameter
Implements ICloneable

Vererbung

Object

DbParameter

OdbcParameter

Implementiert

IDataParameter IDbDataParameter ICloneable

Beispiele

Im folgenden Beispiel werden mehrere Instanzen von OdbcParameter über OdbcParameterCollectionOdbcDataAdaptererstellt. Diese Parameter werden verwendet, um Daten aus der Datenquelle auszuwählen und die Daten in der DataSetzu platzieren. In diesem Beispiel wird davon ausgegangen, dass ein DataSet und bereits OdbcDataAdapter mithilfe des entsprechenden Schemas, der entsprechenden Befehle und der entsprechenden Verbindung erstellt wurden.

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

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

Hinweise

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

Beim Abfragen einer Oracle-Datenbank mithilfe des Microsoft OLE DB-Anbieter für Oracle (MSDAORA) und des ODBC-.NET Framework-Datenanbieters gibt die Verwendung der -Klausel zum Abfragen von LIKE Werten in Feldern mit fester Länge möglicherweise nicht alle erwarteten Übereinstimmungen zurück. Der Grund ist, dass Oracle, wenn Werte für Felder mit fester Länge in einer LIKE -Klausel abgleicht, die gesamte Länge der Zeichenfolge, einschließlich aller nachgestellten Leerzeichen, entspricht. Wenn beispielsweise eine Tabelle in einer Oracle-Datenbank 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, gibt der folgende Code die Zeile nicht zurück.

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

Dies liegt daran, dass Oracle den Spaltenwert als "a" speichert (Auffüllung "a" mit nachgestellten Leerzeichen bis zur festen Feldlänge von 3), die Oracle im Fall eines LIKE Vergleichs von Feldern mit fester Länge nicht als Übereinstimmung für den Parameterwert von "a" behandelt.

Um dieses Problem zu beheben, fügen Sie ein Prozentzeichen ("%") an den Parameterwert ("a%") an, oder verwenden Sie stattdessen einen SQL-Vergleich = .

Konstruktoren

OdbcParameter()	Initialisiert eine neue Instanz der OdbcParameter-Klasse.
OdbcParameter(String, Object)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die den Parameternamen und ein OdbcParameter-Objekt verwendet.
OdbcParameter(String, OdbcType)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die den Parameternamen und den Datentyp verwendet.
OdbcParameter(String, OdbcType, Int32)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die den Parameternamen, den Datentyp und die Länge verwendet.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die Parametername, Datentyp, Länge, Quellspaltenname, Richtung des Parameters, numerische Genauigkeit und andere Eigenschaften verwendet.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die Parametername, Datentyp, Länge, Quellspaltenname, Richtung des Parameters, numerische Genauigkeit und andere Eigenschaften verwendet.
OdbcParameter(String, OdbcType, Int32, String)	Initialisiert eine neue Instanz der OdbcParameter-Klasse, die den Parameternamen, den Datentyp, die Länge und den Quellspaltennamen verwendet.

Eigenschaften

DbType	Ruft den DbType des Parameters ab oder legt ihn fest.
Direction	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Parameter nur zur Eingabe, nur zur Ausgabe oder bidirektional verwendet wird oder ob es sich um einen Parameter für den Rückgabewert einer gespeicherten Prozedur handelt.
IsNullable	Ruft einen Wert ab, der angibt, ob der Parameter NULL-Werte akzeptiert, oder legt diesen fest.
OdbcType	Ruft den OdbcType des Parameters ab oder legt ihn fest.
Offset	Stellt einen Parameter für einen OdbcCommand und optional für seine Zuordnung zu einer DataColumn dar. Diese Klasse kann nicht vererbt werden.
ParameterName	Ruft den Namen der OdbcParameter ab oder legt diesen fest.
Precision	Ruft die Anzahl von Ziffern ab, die zur Darstellung der Value-Eigenschaft verwendet werden kann, oder legt diese fest.
Scale	Ruft die Anzahl der Dezimalstellen ab, in die Value aufgelöst wird, oder legt diese fest.
Size	Ruft die maximale Größe der Daten innerhalb der Spalte ab oder legt diese fest.
SourceColumn	Ruft den Namen der Quellspalte ab, die dem DataSet zugeordnet ist und zum Laden oder Zurückgeben des Value verwendet wird, oder legt diesen fest.
SourceColumnNullMapping	Ruft einen Wert ab, der angibt, ob die Quellspalte NULL-Werte zulässt, oder legt diesen fest. Auf diese Weise kann DbCommandBuilder Update-Anweisungen für Spalten, die NULL-Werte zulassen, ordnungsgemäß generieren.
SourceVersion	Ruft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt diese fest.
Value	Ruft den Wert des Parameters ab oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ResetDbType()	Setzt den diesem OdbcParameter zugeordneten Typ zurück.
ResetOdbcType()	Setzt den diesem OdbcParameter zugeordneten Typ zurück.
ToString()	Ruft eine Zeichenfolge ab, die den ParameterName enthält.

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter Clone().

Weitere Informationen

• Arbeiten mit Befehlen