OleDbCommand Klasse

Definition

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die in einer Datenquelle ausgeführt werden soll.Represents an SQL statement or stored procedure to execute against a data source.

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

Beispiele

Im folgenden Beispiel OleDbCommand werden, zusammen OleDbDataAdapter und, verwendet, OleDbConnection um Zeilen aus einer Access-Datenbank auszuwählen.The following example uses the OleDbCommand, along OleDbDataAdapter and OleDbConnection, to select rows from an Access database. Der ausgefüllte DataSet wird dann zurückgegeben.The filled DataSet is then returned. Im Beispiel wird eine initialisierte DataSet , eine Verbindungs Zeichenfolge, eine Abfrage Zeichenfolge, die eine SQL SELECT-Anweisung ist, und eine Zeichenfolge mit dem Namen der Quelldaten Bank TabelleThe example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the source database table.

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.When an instance of OleDbCommand is created, the read/write properties are set to their initial values. Eine Liste dieser Werte finden Sie unter dem- OleDbCommand Konstruktor.For a list of these values, see the OleDbCommand constructor.

OleDbCommand bietet die folgenden Methoden zum Ausführen von Befehlen in einer Datenquelle:OleDbCommand features the following methods executing commands at a data source:

ElementItem BESCHREIBUNGDescription
ExecuteReader Führt Befehle aus, die Zeilen zurückgeben.Executes commands that return rows. ExecuteReader Sie haben möglicherweise nicht die gewünschte Auswirkung, wenn Sie zum Ausführen von Befehlen wie SQL-SET-Anweisungen verwendet werden.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery Führt Befehle wie INSERT-, DELETE-, Update-und SET-Anweisungen in SQL aus.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Ruft einen einzelnen Wert ab, z. b. einen Aggregatwert aus einer Datenbank.Retrieves a single value, for example, an aggregate value from a database.

Sie können die CommandText -Eigenschaft zurücksetzen und das-Objekt wieder verwenden OleDbCommand .You can reset the CommandText property and reuse the OleDbCommand object. Sie müssen jedoch schließen, OleDbDataReader bevor Sie einen neuen oder vorherigen Befehl ausführen können.However, you must close the OleDbDataReader before you can execute a new or previous command.

Wenn ein schwerwiegender (z. b. OleDbException ein SQL Server Schweregrad von 20 oder höher) von der Methode generiert wird, die ausführt, wird die OleDbCommand OleDbConnection Verbindung möglicherweise geschlossen.If a fatal OleDbException (for example, a SQL Server severity level of 20 or greater) is generated by the method executing an OleDbCommand, the OleDbConnection, the connection may be closed. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.However, the user can reopen the connection and continue.

Konstruktoren

OleDbCommand()

Initialisiert eine neue Instanz der OleDbCommand-Klasse.Initializes a new instance of the OleDbCommand class.

OleDbCommand(String)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage.Initializes a new instance of the OleDbCommand class with the text of the query.

OleDbCommand(String, OleDbConnection)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage und einer OleDbConnection.Initializes a new instance of the OleDbCommand class with the text of the query and an OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Initialisiert eine neue Instanz der OleDbCommand-Klasse mit dem Text der Abfrage, einer OleDbConnection und der Transaction.Initializes a new instance of the OleDbCommand class with the text of the query, an OleDbConnection, and the Transaction.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(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.Gets or sets the SQL statement or stored procedure to execute at the data source.

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.Gets or sets the wait time (in seconds) before terminating an attempt to execute a command and generating an error.

CommandType

Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen Wert fest.Gets or sets a value that indicates how the CommandText property is interpreted.

Connection

Ruft die OleDbConnection ab, die von dieser Instanz des OleDbCommand verwendet wird, oder legt diese fest.Gets or sets the OleDbConnection used by this instance of the OleDbCommand.

Container

Ruft die IContainer ab, die in der Component enthalten ist.Gets the IContainer that contains the Component.

(Geerbt von Component)
DbConnection

Ruft bei Überschreibung in einer abgeleiteten Klasse die DbConnection-Eigenschaft ab, die für diesen DbCommand verwendet wird.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Geerbt von DbCommand)
DbParameterCollection

Ruft bei Überschreibung in einer abgeleiteten Klasse die Sammlung von DbParameter-Objekten ab.When overridden in a derived class, gets the collection of DbParameter objects.

(Geerbt von DbCommand)
DbTransaction

Ruft bei Überschreibung in einer abgeleiteten Klasse die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt diese Transaktion fest.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Geerbt von DbCommand)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(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.Gets or sets a value that indicates whether the command object should be visible in a customized Windows Forms Designer control.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
Parameters

Ruft das OleDbParameterCollection ab.Gets the OleDbParameterCollection.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
Transaction

Ruft die OleDbTransaction ab, in der der OleDbCommand ausgeführt wird, bzw. legt diese fest.Gets or sets the OleDbTransaction within which the OleDbCommand executes.

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.Gets or sets how command results are applied to the DataRow when used by the Update method of the OleDbDataAdapter.

Methoden

Cancel()

Versucht, die Ausführung eines OleDbCommand abzubrechen.Tries to cancel the execution of an OleDbCommand.

Clone()

Erstellt ein neues OleDbCommand-Objekt, das eine Kopie der aktuellen Instanz darstellt.Creates a new OleDbCommand object that is a copy of the current instance.

CreateDbParameter()

Erstellt bei Überschreibung in einer abgeleiteten Klasse eine neue Instanz eines DbParameter-Objekts.When overridden in a derived class, creates a new instance of a DbParameter object.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
CreateParameter()

Erstellt eine neue Instanz eines OleDbParameter -Objekts.Creates a new instance of an OleDbParameter object.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Geerbt von DbCommand)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von DbCommand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

(Geerbt von DbCommand)
Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Geerbt von Component)
DisposeAsync()

Stellt das Befehlsobjekt asynchron bereit.Asynchronously diposes the command object.

(Geerbt von DbCommand)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Führt bei Überschreibung in einer abgeleiteten Klasse den Befehlstext für die Verbindung aus.When overridden in a derived class, executes the command text against the connection.

(Geerbt von DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementierungen können diese Anforderung ignorieren.Implementations may ignore this request.

(Geerbt von DbCommand)
ExecuteNonQuery()

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteNonQueryAsync()

Eine asynchrone Version von ExecuteNonQuery(), die eine SQL-Anweisung für ein Verbindungsobjekt ausführt.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Geerbt von DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Geerbt von DbCommand)
ExecuteReader()

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

ExecuteReader(CommandBehavior)

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OleDbDataReader.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

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

(Geerbt von DbCommand)
ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Diese Methode gibt eine Benachrichtigung darüber weiter, dass Vorgänge abgebrochen werden sollen.This method propagates a notification that operations should be canceled.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(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.Executes the query, and returns the first column of the first row in the result set returned by the query. Weitere Spalten oder Zeilen werden ignoriert.Additional columns or rows are ignored.

ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die die Abfrage ausführt und die erste Spalte der ersten Zeile im Resultset zurückgibt.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Geerbt von DbCommand)
ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Geerbt von DbCommand)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.Creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken)

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Geerbt von DbCommand)
ResetCommandTimeout()

Setzt die CommandTimeout-Eigenschaft auf den Standardwert zurück.Resets the CommandTimeout property to the default value.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter Clone().For a description of this member, see Clone().

IDbCommand.Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Geerbt von DbCommand)
IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter -Objekts.Creates a new instance of an IDbDataParameter object.

IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter -Objekts.Creates a new instance of an IDbDataParameter object.

(Geerbt von DbCommand)
IDbCommand.ExecuteReader()

Eine Beschreibung dieses Elements finden Sie unter ExecuteReader().For a description of this member, see ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters

Ruft das IDataParameterCollection ab.Gets the IDataParameterCollection.

(Geerbt von DbCommand)
IDbCommand.Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.Gets or sets the DbTransaction within which this DbCommand object executes.

(Geerbt von DbCommand)

Gilt für:

Weitere Informationen