OleDbCommand Klasse

Definition

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

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
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 sealed class OleDbCommand : 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
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
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Vererbung
OleDbCommand
Vererbung
Vererbung
Implementiert

Beispiele

Im folgenden Beispiel wird verwendet, OleDbCommandzusammen OleDbDataAdapter mit und OleDbConnection, um Zeilen aus einer Access-Datenbank auszuwählen. Die ausgefüllte DataSet wird dann zurückgegeben. Im Beispiel wird eine initialisierte DataSet, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, bei der es sich um eine SQL SELECT-Anweisung handelt, und eine Zeichenfolge übergeben, 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 verfügt über die folgenden Methoden, die Befehle in einer Datenquelle ausführen:

Element Beschreibung
ExecuteReader Führt Befehle aus, die Zeilen zurückgeben. ExecuteReader möglicherweise nicht den gewünschten Effekt haben, wenn sie zum Ausführen von Befehlen wie SQL SET-Anweisungen verwendet werden.
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 Objekt wiederverwenden OleDbCommand . Sie müssen jedoch schließen OleDbDataReader , 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) von der -Methode generiert wird, die OleDbConnectionein OleDbCommandausführt, kann die Verbindung geschlossen werden. Die Benutzer können die Verbindung aber 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 einer OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage, einer OleDbConnection und 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 für die Datenquelle ausgeführt werden soll, oder legt diese fest.

CommandTimeout

Ruft die Zeit (in Sekunden) ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.

CommandType

Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen Wert fest.

Connection

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

Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DbConnection

Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest.

(Geerbt von DbCommand)
DbParameterCollection

Ruft die Auflistung von DbParameter-Objekten ab.

(Geerbt von DbCommand)
DbTransaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.

(Geerbt von DbCommand)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
DesignTimeVisible

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Steuerelement für Windows Forms-Designer sichtbar sein soll, oder legt diesen fest.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
Parameters

Ruft das OleDbParameterCollection ab.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
Transaction

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

UpdatedRowSource

Ruft ab oder legt fest, wie die Ergebnisse von Befehlen auf DataRow angewendet werden, wenn diese von der Update-Methode von OleDbDataAdapter verwendet wird.

Methoden

Cancel()

Versucht, die Ausführung eines OleDbCommand abzubrechen.

Clone()

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

CreateDbParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.

(Geerbt von DbCommand)
CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
CreateParameter()

Erstellt eine neue Instanz eines OleDbParameter -Objekts.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

(Geerbt von DbCommand)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von DbCommand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von DbCommand)
Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von Component)
DisposeAsync()

Stellt das Befehlsobjekt asynchron bereit.

(Geerbt von DbCommand)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Führt den Befehl für seine Verbindung aus und gibt einen zurück DbDataReader , der 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. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren.

(Geerbt von DbCommand)
ExecuteNonQuery()

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

ExecuteNonQueryAsync()

Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für sein 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 entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

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

(Geerbt von DbCommand)
ExecuteReader()

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.

ExecuteReader(CommandBehavior)

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OleDbDataReader.

ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader, die den Befehl für seine 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 seine 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 seine 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 in dem von der Abfrage zurückgegebenen Resultset zurück. Weitere 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 entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

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

(Geerbt von DbCommand)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

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

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des 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 für die Datenquelle.

PrepareAsync(CancellationToken)

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

(Geerbt von DbCommand)
ResetCommandTimeout()

Setzt die CommandTimeout-Eigenschaft auf den Standardwert zurück.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)

Ereignisse

Disposed

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

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter Clone().

IDbCommand.Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.

(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 Elements finden Sie unter ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.

IDbCommand.Parameters

Ruft das IDataParameterCollection ab.

(Geerbt von DbCommand)
IDbCommand.Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.

(Geerbt von DbCommand)

Gilt für:

Weitere Informationen