Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

OdbcParameter-Klasse

 

Veröffentlicht: Oktober 2016

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

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

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

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

NameBeschreibung
System_CAPS_pubmethodOdbcParameter()

Initialisiert eine neue Instanz der OdbcParameter-Klasse.

System_CAPS_pubmethodOdbcParameter(String, Object)

Initialisiert eine neue Instanz der der OdbcParameter Klasse, die den Namen des Parameters verwendet und ein OdbcParameter Objekt.

System_CAPS_pubmethodOdbcParameter(String, OdbcType)

Initialisiert eine neue Instanz der OdbcParameter -Klasse, die den Parameternamen und den Datentyp verwendet.

System_CAPS_pubmethodOdbcParameter(String, OdbcType, Int32)

Initialisiert eine neue Instanz der OdbcParameter -Klasse, die den Parameternamen, den Datentyp und die Länge verwendet.

System_CAPS_pubmethodOdbcParameter(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.

System_CAPS_pubmethodOdbcParameter(String, OdbcType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)

Initialisiert eine neue Instanz der OdbcParameter -Klasse, die den Parameternamen, Datentyp, Länge, Quellspaltennamen, Richtung des Parameters, numerische Genauigkeit und andere Eigenschaften verwendet.

System_CAPS_pubmethodOdbcParameter(String, OdbcType, Int32, String)

Initialisiert eine neue Instanz der OdbcParameter -Klasse, die Parametername, Datentyp, Länge und Quellspaltennamen verwendet.

NameBeschreibung
System_CAPS_pubpropertyDbType

Ruft den DbType des Parameters ab oder legt ihn fest.(Überschreibt DbParameter.DbType.)

System_CAPS_pubpropertyDirection

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.(Überschreibt DbParameter.Direction.)

System_CAPS_pubpropertyIsNullable

Ruft einen Wert ab, der angibt, ob der Parameter NULL-Werte akzeptiert, oder legt diesen fest.(Überschreibt DbParameter.IsNullable.)

System_CAPS_pubpropertyOdbcType

Ruft den OdbcType des Parameters ab oder legt ihn fest.

System_CAPS_pubpropertyParameterName

Ruft den Namen der OdbcParameter ab oder legt diesen fest.(Überschreibt DbParameter.ParameterName.)

System_CAPS_pubpropertyPrecision

Ruft ab oder legt die Anzahl der Ziffern für die Darstellung der Value Eigenschaft.

System_CAPS_pubpropertyScale

Ruft die Anzahl der Dezimalstellen ab, in die Value aufgelöst wird, oder legt diese fest.

System_CAPS_pubpropertySize

Ruft ab oder legt die maximale Größe der Daten innerhalb der Spalte.(Überschreibt DbParameter.Size.)

System_CAPS_pubpropertySourceColumn

Ruft ab oder legt den Namen der Quellspalte zugeordnet der DataSet und zum Laden oder Zurückgeben der Value.(Überschreibt DbParameter.SourceColumn.)

System_CAPS_pubpropertySourceColumnNullMapping

Legt einen Wert fest, der angibt, ob die Quellspalte NULL-Werte zulässt, oder ruft ihn ab. Auf diese Weise können DbCommandBuilder ordnungsgemäß generieren, die Update-Anweisungen für die NULL-Werte zulassen.(Überschreibt DbParameter.SourceColumnNullMapping.)

System_CAPS_pubpropertySourceVersion

Ruft ab oder legt die DataRowVersion verwenden, beim Laden von Value.(Überschreibt DbParameter.SourceVersion.)

System_CAPS_pubpropertyValue

Ruft den Wert des Parameters ab oder legt diesen fest.(Überschreibt DbParameter.Value.)

NameBeschreibung
System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodResetDbType()

Setzt den diesem OdbcParameter zugeordneten Typ zurück.(Überschreibt DbParameter.ResetDbType().)

System_CAPS_pubmethodResetOdbcType()

Setzt den diesem OdbcParameter zugeordneten Typ zurück.

System_CAPS_pubmethodToString()

Ruft eine Zeichenfolge ab, die den ParameterName enthält.(Überschreibt Object.ToString().)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter ICloneable.Clone.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataParameter.Precision

Gibt die Genauigkeit numerischer Parameter an.(Geerbt von „DbParameter“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataParameter.Scale

Eine Beschreibung dieses Elements finden Sie unter IDbDataParameter.Scale.(Geerbt von „DbParameter“.)

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

Beim Abfragen einer Oracle-Datenbank mithilfe von Microsoft OLE DB-Anbieter für Oracle (MSDAORA) und den ODBC .NET Framework-Datenanbieter mithilfe der LIKE -Klausel, um den Abfragewerte in Feldern mit fester Länge möglicherweise nicht alle erwartete Übereinstimmungen zurück. Der Grund ist, dass Oracle beim Werte für Felder mit fester Länge in einem LIKE -Klausel die gesamte Länge der Zeichenfolge, einschließlich aller auffüllleerzeichen. Wenn eine Tabelle enthält eine Oracle-Datenbank z. B. ein Feld mit dem Namen "Field1", die als definiert ist char(3), und geben Sie den Wert "a" in eine Zeile der Tabelle den folgenden Code wird die Zeile nicht zurückgeben.

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 ist da Oracle den Spaltenwert als "a" gespeichert (padding "a" sind Leerzeichen angefügt, um die feste Länge von 3), die Oracle nicht als Übereinstimmung für den Parameterwert "a" in der behandelt eine LIKE Vergleich der Felder fester Länge.

Um dieses Problem zu beheben, fügen Sie ein Platzhalterzeichen Prozent ("%") den Wert des Parameters ("a%"), oder verwenden Sie eine SQL = Vergleich stattdessen.

Das folgende Beispiel erstellt mehrere Instanzen von OdbcParameter über die OdbcParameterCollection innerhalb der OdbcDataAdapter. Diese Parameter werden verwendet, um Daten aus der Datenquelle ausgewählt und werden die Daten in der DataSet. In diesem Beispiel wird vorausgesetzt, dass ein DataSet und ein OdbcDataAdapter mithilfe des entsprechenden Schemas Befehle und Verbindung bereits 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;
}

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: