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

OleDbParameter-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen Parameter für einen OleDbCommand und optional für seine Zuordnung zu einer DataSet-Spalte dar. Diese Klasse kann nicht vererbt werden.

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

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbParameter
      System.Data.OleDb.OleDbParameter

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

NameBeschreibung
System_CAPS_pubmethodOleDbParameter()

Initialisiert eine neue Instanz der OleDbParameter-Klasse.

System_CAPS_pubmethodOleDbParameter(String, Object)

Initialisiert eine neue Instanz der der OleDbParameter Klasse, die den Parameternamen und den Wert des neuen OleDbParameter.

System_CAPS_pubmethodOleDbParameter(String, OleDbType)

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

System_CAPS_pubmethodOleDbParameter(String, OleDbType, Int32)

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

System_CAPS_pubmethodOleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

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

System_CAPS_pubmethodOleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)

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

System_CAPS_pubmethodOleDbParameter(String, OleDbType, Int32, String)

Initialisiert eine neue Instanz der OleDbParameter -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 ab oder legt einen Wert, der angibt, ob der Parameter reiner Ausgabe, bidirektional oder Rückgabewert-Parameter einer gespeicherten Prozedur fest.(Ü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_pubpropertyOleDbType

Ruft den OleDbType des Parameters ab oder legt ihn fest.

System_CAPS_pubpropertyParameterName

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

System_CAPS_pubpropertyPrecision

Ruft die maximale Anzahl von Ziffern ab, die zur Darstellung der Value-Eigenschaft verwendet werden kann, oder legt diese fest.

System_CAPS_pubpropertyScale

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

System_CAPS_pubpropertySize

Dient zum Abrufen oder Festlegen der maximalen Größe (in Bytes) der Daten in 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. Dadurch kann DbCommandBuilder ordnungsgemäß Update-Anweisungen für Spalten generieren, 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 OleDbParameter zugeordneten Typ zurück.(Überschreibt DbParameter.ResetDbType().)

System_CAPS_pubmethodResetOleDbType()

Setzt den diesem OleDbParameter 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“.)

Der OLE DB-.NET Framework-Datenanbieter verwendet, die markiert sind mit einem Fragezeichen (?) anstelle von benannten Parametern.

Beim Abfragen einer Oracle-Datenbank mithilfe von Microsoft OLE DB-Anbieter für Oracle (MSDAORA) und den OLE DB-.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 OleDbParameter über die OleDbParameterCollection Auflistung innerhalb der OleDbDataAdapter. 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 OleDbDataAdapter mithilfe des entsprechenden Schemas Befehle und Verbindung bereits erstellt wurden.

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

.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: