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

OleDbCommand-Klasse

 

Veröffentlicht: Oktober 2016

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die in einer Datenquelle ausgeführt werden soll.

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.OleDb.OleDbCommand

public sealed class OleDbCommand : DbCommand, ICloneable, IDbCommand, 
	IDisposable

NameBeschreibung
System_CAPS_pubmethodOleDbCommand()

Initialisiert eine neue Instanz der OleDbCommand-Klasse.

System_CAPS_pubmethodOleDbCommand(String)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage.

System_CAPS_pubmethodOleDbCommand(String, OleDbConnection)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage und einer OleDbConnection.

System_CAPS_pubmethodOleDbCommand(String, OleDbConnection, OleDbTransaction)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage, einer OleDbConnection und der Transaction.

NameBeschreibung
System_CAPS_pubpropertyCommandText

Ruft ab oder legt sie fest, die SQL-Anweisung oder gespeicherte Prozedur in der Datenquelle ausgeführt.(Überschreibt DbCommand.CommandText.)

System_CAPS_pubpropertyCommandTimeout

Ruft ab oder legt die Wartezeit, bevor ein Versuch zum Ausführen eines Befehls beendet und ein Fehler generiert.(Überschreibt DbCommand.CommandTimeout.)

System_CAPS_pubpropertyCommandType

Ruft ab oder legt einen Wert an der CommandText -Eigenschaft interpretiert wird.(Überschreibt DbCommand.CommandType.)

System_CAPS_pubpropertyConnection

Ruft die OleDbConnection ab, die von dieser Instanz des OleDbCommand verwendet wird, oder legt diese fest.

System_CAPS_pubpropertyContainer

Ruft die IContainer enthält die Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyDesignTimeVisible

Ruft ab oder legt einen Wert, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Steuerelement für Windows Forms-Designer sichtbar sein soll.(Überschreibt DbCommand.DesignTimeVisible.)

System_CAPS_pubpropertyParameters
System_CAPS_pubpropertySite

Ruft ab oder legt die ISite von der Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyTransaction

Ruft die OleDbTransaction ab, in der der OleDbCommand ausgeführt wird, bzw. legt diese fest.

System_CAPS_pubpropertyUpdatedRowSource

Ruft ab oder legt sie fest, wie die Ergebnisse von Befehlen auf angewendet werden die DataRow bei der durch die Update Methode der OleDbDataAdapter.(Überschreibt DbCommand.UpdatedRowSource.)

NameBeschreibung
System_CAPS_pubmethodCancel()

Versucht, das Abbrechen der Ausführungsstatus einer OleDbCommand.(Überschreibt DbCommand.Cancel().)

System_CAPS_pubmethodClone()

Erstellt ein neues OleDbCommand -Objekt, das eine Kopie der aktuellen Instanz ist.

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodCreateParameter()

Erstellt eine neue Instanz von einem OleDbParameter Objekt.

System_CAPS_pubmethodDispose()

Gibt alle vom Component verwendeten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodExecuteNonQuery()

Führt eine SQL­Anweisung für die Connection und gibt die Anzahl der betroffenen Zeilen zurück.(Überschreibt DbCommand.ExecuteNonQuery().)

System_CAPS_pubmethodExecuteNonQueryAsync()

Eine asynchrone Version der ExecuteNonQuery, das ausgeführt wird, einer SQL-Anweisung für ein Connection-Objekt.

Ruft ExecuteNonQueryAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version der ExecuteNonQuery. Anbieter sollten durch eine geeignete Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone ExecuteNonQuery Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen Abbruchtoken übergeben. Ausgelöste Ausnahmen ExecuteNonQuery Updates werden über die zurückgegebene Ausnahme einer Aufgabe-Eigenschaft.

Andere Methoden und Eigenschaften nicht Aufrufen der DbCommand Objekt, bis die zurückgegebene Aufgabe abgeschlossen ist.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReader()

Sendet die CommandText an der Connection und erstellt eine OleDbDataReader.

System_CAPS_pubmethodExecuteReader(CommandBehavior)

Sendet die CommandText an der Connection, und erstellt ein OleDbDataReader mit einer der der CommandBehavior Werte.

System_CAPS_pubmethodExecuteReaderAsync()

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader.

Ruft ExecuteDbDataReaderAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CancellationToken)

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader. Diese Methode gibt eine Benachrichtigung, dass Vorgänge abgebrochen werden sollen.

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader.

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.(Überschreibt DbCommand.ExecuteScalar().)

System_CAPS_pubmethodExecuteScalarAsync()

Eine asynchrone Version der ExecuteScalar, dem führt die Abfrage aus und gibt die erste Spalte der ersten Zeile in der von der Abfrage zurückgegebenen Resultset zurück. Alle anderen Spalten und Zeilen werden ignoriert.

Ruft ExecuteScalarAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version der ExecuteScalar. Anbieter sollten durch eine geeignete Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone ExecuteScalar Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen Abbruchtoken übergeben. ExecuteScalar ausgelöste Ausnahmen werden über die zurückgegebene Ausnahme einer Aufgabe Eigenschaft mitgeteilt.

Andere Methoden und Eigenschaften nicht Aufrufen der DbCommand Objekt, bis die zurückgegebene Aufgabe abgeschlossen ist.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetLifetimeService()

Ruft die aktuellen Service-Objekt, das die Lebensdauerrichtlinien für diese Instanz steuert.(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 Lebensdauerrichtlinien für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodPrepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.(Überschreibt DbCommand.Prepare().)

System_CAPS_pubmethodResetCommandTimeout()

Setzt die CommandTimeout Eigenschaft auf den Standardwert.

System_CAPS_pubmethodToString()

Gibt eine String mit dem Namen der Component, sofern vorhanden. Diese Methode darf nicht überschrieben werden.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_pubeventDisposed

Tritt auf, wenn die Komponente, durch einen Aufruf freigegeben wird der Dispose Methode.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter-Objekts.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader()

Eine Beschreibung dieses Elements finden Sie unter IDbCommand.ExecuteReader.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader(CommandBehavior)

Führt die CommandText für die Connection, und erstellt ein IDataReader mithilfe eines der der CommandBehavior Werte.

System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter ICloneable.Clone.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Parameters

Ruft das IDataParameterCollection ab.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.(Geerbt von „DbCommand“.)

Wenn eine Instanz des OleDbCommand erstellt wird, werden die Lese-/Schreibzugriff Eigenschaften werden auf ihre Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie in der OleDbCommand Konstruktor.

OleDbCommand enthält die folgenden Methoden Ausführen von Befehlen in einer Datenquelle:

Element

Beschreibung

ExecuteReader

Führt Befehle aus, die Zeilen zurückgibt. ExecuteReader möglicherweise nicht den Effekt, der verwendet werden soll zum Ausführen von Befehlen, wie z. B. SQL-SET-Anweisungen.

ExecuteNonQuery

Führt Befehle wie SQL INSERT, DELETE, UPDATE und SET-Anweisungen.

ExecuteScalar

Ruft einen einzelnen Wert, z. B. einen Aggregatwert aus einer Datenbank ab.

Können Zurücksetzen der CommandText -Eigenschaft und die Wiederverwendung der OleDbCommand Objekt. Sie müssen jedoch schließen die OleDbDataReader bevor ein neuer oder zuvor verwendeter Befehl ausgeführt werden kann.

Wenn eine schwerwiegende OleDbException (z. B. mit einem SQL Server-Schweregrad von 20 oder höher) wird von der Methode ausgeführten generiert ein OleDbCommand, OleDbConnection, möglicherweise die Verbindung geschlossen. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Im folgenden Beispiel wird die OleDbCommand, gemeinsam OleDbDataAdapter und OleDbConnection, um Zeilen aus einer Access-Datenbank auszuwählen. Die gefüllte DataSet wird zurückgegeben. Im Beispiel wird ein initialisiertes übergeben DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge, die eine SQL SELECT-Anweisung ist eine Zeichenfolge, die den Namen der Quelltabelle für die Datenbank ist.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

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