Teilen über


OleDbCommand Klasse

Definition

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

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Vererbung
Vererbung
Implementiert

Beispiele

Im folgenden Beispiel werden die OleDbCommandentlang OleDbDataAdapter und OleDbConnectionverwendet, um Zeilen aus einer Access-Datenbank auszuwählen. Die ausgefüllte DataSet wird dann zurückgegeben. Das Beispiel wird an eine initialisierte DataSetübergeben, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, die eine SQL SELECT-Anweisung ist, und eine Zeichenfolge, die den Namen der Quelldatenbanktabelle darstellt.

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();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Hinweise

Wenn eine Instanz von OleDbCommand erstellt wird, werden die Lese-/Schreibeigenschaften auf ihre Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im OleDbCommand-Konstruktor.

OleDbCommand bietet die folgenden Methoden zum Ausführen von Befehlen in einer Datenquelle:

Artikel Beschreibung
ExecuteReader Führt Befehle aus, die Zeilen zurückgeben. ExecuteReader haben möglicherweise nicht den gewünschten Effekt, wenn Sie Befehle wie SQL SET-Anweisungen ausführen möchten.
ExecuteNonQuery Führt Befehle wie SQL INSERT-, DELETE-, UPDATE- und SET-Anweisungen aus.
ExecuteScalar Ruft einen einzelnen Wert ab, z. B. einen Aggregatwert aus einer Datenbank.

Sie können die CommandText-Eigenschaft zurücksetzen und das OleDbCommand-Objekt wiederverwenden. Sie müssen die OleDbDataReader jedoch schließen, bevor Sie einen neuen oder vorherigen Befehl ausführen können.

Wenn ein schwerwiegender OleDbException (z. B. ein SQL Server-Schweregrad von 20 oder höher) durch die Methode generiert wird, die ein OleDbCommandausführt, kann OleDbConnectiondie Verbindung geschlossen werden. Der Benutzer kann die Verbindung jedoch erneut öffnen und fortfahren.

Konstruktoren

OleDbCommand()

Initialisiert eine neue Instanz der OleDbCommand Klasse.

OleDbCommand(String)

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

OleDbCommand(String, OleDbConnection)

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

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Initialisiert eine neue Instanz der OleDbCommand Klasse mit dem Text der Abfrage, einer OleDbConnectionund der Transaction.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
CommandText

Ruft die SQL-Anweisung oder gespeicherte Prozedur ab, die an der Datenquelle ausgeführt werden soll, oder legt sie fest.

CommandTimeout

Ruft die Wartezeit (in Sekunden) ab, bevor ein Versuch zum Ausführen eines Befehls beendet und ein Fehler generiert wird, oder legt diese fest.

CommandType

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie die CommandText -Eigenschaft interpretiert wird.

Connection

Dient zum Abrufen oder Festlegen der OleDbConnection, die von dieser Instanz des OleDbCommandverwendet wird.

Container

Ruft die IContainer ab, die den Componententhält.

(Geerbt von Component)
DbConnection

Dient zum Abrufen oder Festlegen der von diesem DbCommandverwendeten DbConnection.

(Geerbt von DbCommand)
DbParameterCollection

Ruft die Auflistung von DbParameter -Objekten ab.

(Geerbt von DbCommand)
DbTransaction

Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird.

(Geerbt von DbCommand)
DesignMode

Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet.

(Geerbt von Component)
DesignTimeVisible

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Befehlsobjekt in einem angepassten Windows Forms Designer -Steuerelement sichtbar sein soll.

Events

Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind.

(Geerbt von Component)
Parameters

Ruft die OleDbParameterCollectionab.

Site

Dient zum Abrufen oder Festlegen des ISite des Component.

(Geerbt von Component)
Transaction

Dient zum Abrufen oder Festlegen des OleDbTransaction, in dem die OleDbCommand ausgeführt wird.

UpdatedRowSource

Ruft ab oder legt fest, wie Befehlsergebnisse auf die DataRow angewendet werden, wenn sie von der Update -Methode der OleDbDataAdapterverwendet wird.

Methoden

Cancel()

Versucht, die Ausführung eines OleDbCommandabzubrechen.

Clone()

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

CreateDbParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.

(Geerbt von DbCommand)
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
CreateParameter()

Erstellt eine neue Instanz eines OleDbParameter-Objekts.

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

(Geerbt von DbCommand)
Dispose()

Gibt alle vom Componentverwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die vom DbCommand verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von DbCommand)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die vom Component verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von Component)
DisposeAsync()

Das Befehlsobjekt wird asynchron eingetaucht.

(Geerbt von DbCommand)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Führt den Befehl für seine Verbindung aus und gibt eine DbDataReader zurück, die für den Zugriff auf die Ergebnisse verwendet werden kann.

(Geerbt von DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader Überladungen bereitzustellen.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

Diese Methode akzeptiert ein Abbruchtoken, mit dem der Vorgang frühzeitig abgebrochen werden kann. Implementierungen können diese Anforderung ignorieren.

(Geerbt von DbCommand)
ExecuteNonQuery()

Führt eine SQL-Anweisung für das Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.

ExecuteNonQueryAsync()

Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für das Verbindungsobjekt ausführt und die Anzahl der betroffenen Zeilen zurückgibt.

Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf.

(Geerbt von DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

(Geerbt von DbCommand)
ExecuteReader()

Sendet die CommandText an die Connection und erstellt eine OleDbDataReader.

ExecuteReader(CommandBehavior)

Sendet den CommandText an den Connectionund erstellt eine OleDbDataReader mit einem der CommandBehavior Werte.

ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) mit CancellationToken.None auf.

(Geerbt von DbCommand)
ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)auf.

(Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)auf.

(Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)auf.

(Geerbt von DbCommand)
ExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, die von der Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.

ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die den Befehl ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.

(Geerbt von DbCommand)
ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteScalar ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

(Geerbt von DbCommand)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird.

(Geerbt von Component)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls in der Datenquelle.

PrepareAsync(CancellationToken)

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls in der Datenquelle.

(Geerbt von DbCommand)
ResetCommandTimeout()

Setzt die eigenschaft CommandTimeout auf den Standardwert zurück.

ToString()

Gibt einen String zurück, der den Namen der Componententhält, falls vorhanden. Diese Methode sollte nicht außer Kraft gesetzt werden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() -Methode verworfen wird.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Eine Beschreibung dieses Mitglieds finden Sie unter Clone().

IDbCommand.Connection

Dient zum Abrufen oder Festlegen der IDbConnection, die von dieser Instanz des IDbCommandverwendet wird.

(Geerbt von DbCommand)
IDbCommand.CreateParameter()

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

Erstellt eine neue Instanz eines IDbDataParameter-Objekts.

IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter-Objekts.

(Geerbt von DbCommand)
IDbCommand.ExecuteReader()

Eine Beschreibung dieses Mitglieds finden Sie unter ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Führt den CommandText für den Connectionaus und erstellt eine IDataReader unter Verwendung eines der CommandBehavior Werte.

IDbCommand.Parameters

Ruft die IDataParameterCollectionab.

(Geerbt von DbCommand)
IDbCommand.Transaction

Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird.

(Geerbt von DbCommand)

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für:

Weitere Informationen