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
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
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, IDisposable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
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
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
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
OleDbCommand
Vererbung
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel werden die OleDbCommandZeilen aus einer Access-Datenbank zusammen mit OleDbDataAdapter und OleDbConnectionzum Auswählen von Zeilen aus einer Access-Datenbank verwendet. Die Ausgefüllte DataSet wird dann zurückgegeben. Das Beispiel wird an eine initialisierte DataSet, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, eine SQL SELECT-Anweisung 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 erstellt OleDbCommand 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:

Element Description
ExecuteReader Führt Befehle aus, die Zeilen zurückgeben. ExecuteReader Hat möglicherweise nicht den Gewünschten Effekt, wenn Sie Befehle wie SQL SET-Anweisungen ausführen.
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 den OleDbDataReader Befehl jedoch schließen, bevor Sie einen neuen oder vorherigen Befehl ausführen können.

Wenn ein schwerwiegender OleDbException Wert (z. B. ein SQL Server-Schweregrad von 20 oder höher) durch die Methode generiert wird, die eine OleDbCommand, die OleDbConnectionVerbindung schließen kann. Der Benutzer kann die Verbindung jedoch erneut öffnen und fortfahren.

Konstruktoren

Name Beschreibung
OleDbCommand()

Initialisiert eine neue Instanz der OleDbCommand-Klasse.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

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

OleDbCommand(String, OleDbConnection)

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

OleDbCommand(String)

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

Eigenschaften

Name Beschreibung
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 von dieser Instanz der OleDbCommand.

Container

Ruft die IContainer ab, die den Componententhält.

(Geerbt von Component)
DbConnection

Dient zum Abrufen oder Festlegen der DbConnection von diesem DbCommandverwendeten .

(Geerbt von DbCommand)
DbParameterCollection

Ruft die Auflistung von -Objekten ab DbParameter .

(Geerbt von DbCommand)
DbTransaction

Dient zum Abrufen oder Festlegen des DbTransaction Objekts, 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 OleDbParameterCollection ab.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
Transaction

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

UpdatedRowSource

Ruft ab oder legt fest, wie Befehlsergebnisse angewendet DataRow werden, wenn von der Update Methode der OleDbDataAdapter.

Methoden

Name Beschreibung
Cancel()

Versucht, die Ausführung einer .OleDbCommand

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()

Gibt alle vom Componentverwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

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

(Geerbt von Component)
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 ein DbDataReader Element zurück, das 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 die Connection 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 ausgelöst ExecuteNonQuery() werden, werden über die zurückgegebene Task Exception-Eigenschaft mitgeteilt.

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

(Geerbt von DbCommand)
ExecuteReader()

Sendet die CommandText an und Connection erstellt eine OleDbDataReader.