OleDbCommand OleDbCommand OleDbCommand OleDbCommand Class

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

Beispiele

Im folgenden Beispiel wird die OleDbCommand, zusammen OleDbDataAdapter und OleDbConnection, um Zeilen aus einer Access-Datenbank auswählen.The following example uses the OleDbCommand, along OleDbDataAdapter and OleDbConnection, to select rows from an Access database. Die ausgefüllte DataSet wird zurückgegeben.The filled DataSet is then returned. Im Beispiel wird ein initialisiertes übergeben DataSet, eine Verbindungszeichenfolge, eine Abfragezeichenfolge, die eine SQL SELECT-Anweisung und eine Zeichenfolge, die der Name der Quelltabelle für die Datenbank ist.The 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 des OleDbCommand wird erstellt, die Lese-/Schreibzugriff Eigenschaften auf die ursprünglichen Werte festgelegt werden.When an instance of OleDbCommand is created, the read/write properties are set to their initial values. Eine Liste dieser Werte finden Sie in der OleDbCommand Konstruktor.For a list of these values, see the OleDbCommand constructor.

OleDbCommand enthält die folgenden Methoden, die Ausführung von Befehlen an einer Datenquelle:OleDbCommand features the following methods executing commands at a data source:

ElementItem BeschreibungDescription
ExecuteReader Führt Befehle, die Zeilen zurückgeben.Executes commands that return rows. ExecuteReader möglicherweise nicht den gewünschten Effekt, wenn verwendet, Befehle wie z. B. SQL SET-Anweisungen auszuführen.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery Führt Befehle wie z. B. SQL-INSERT, DELETE, UPDATE und SET-Anweisungen.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Ruft einen einzelnen Wert, z. B. einen Aggregatwert aus einer Datenbank ab.Retrieves a single value, for example, an aggregate value from a database.

Können Sie Zurücksetzen der CommandText -Eigenschaft und die Wiederverwendung der OleDbCommand Objekt.You can reset the CommandText property and reuse the OleDbCommand object. Sie müssen jedoch schließen die OleDbDataReader , bevor Sie einen neuen oder die vorherigen-Befehl ausgeführt werden können.However, you must close the OleDbDataReader before you can execute a new or previous command.

Wenn ein schwerwiegender OleDbException (z. B. mit einem SQL Server-Schweregrad von 20 oder höher) wird generiert, indem Sie Ausführung der Methode ein OleDbCommand, OleDbConnection, die Verbindung kann geschlossen werden.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() OleDbCommand() OleDbCommand() OleDbCommand()

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

OleDbCommand(String) OleDbCommand(String) OleDbCommand(String) 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) OleDbCommand(String, OleDbConnection) OleDbCommand(String, OleDbConnection) 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) OleDbCommand(String, OleDbConnection, OleDbTransaction) OleDbCommand(String, OleDbConnection, OleDbTransaction) 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 CanRaiseEvents CanRaiseEvents 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.

(Inherited from Component)
CommandText CommandText CommandText CommandText

Ruft ab oder legt sie fest, die SQL-Anweisung oder gespeicherte Prozedur in der Datenquelle ausgeführt.Gets or sets the SQL statement or stored procedure to execute at the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Übernimmt oder bestimmt die Wartezeit vor dem Versuch einer befehlsausführung beendet und einen Fehler generiert.Gets or sets the wait time before terminating an attempt to execute a command and generating an error.

CommandType CommandType CommandType 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 Connection Connection 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 Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

Ruft ab oder legt einen Wert, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Windows Forms-Designer-Steuerelement sichtbar sein soll.Gets or sets a value that indicates whether the command object should be visible in a customized Windows Forms Designer control.

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

(Inherited from Component)
Parameters Parameters Parameters Parameters

Ruft das OleDbParameterCollection ab.Gets the OleDbParameterCollection.

Site Site Site Site

Ruft die ISite der Component ab oder legt diese fest.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction 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 UpdatedRowSource UpdatedRowSource UpdatedRowSource

Ruft ab oder legt sie fest, wie die Ergebnisse von Befehlen auf angewendet werden die DataRow bei Verwendung durch die Update Methode der OleDbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update method of the OleDbDataAdapter.

Methoden

Cancel() Cancel() Cancel() Cancel()

Versucht, das Abbrechen der Ausführungsstatus einer OleDbCommand.Tries to cancel the execution of an OleDbCommand.

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

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

Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

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

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Sendet die CommandText auf die Connection und erstellt eine OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Sendet die CommandText auf die Connection, und erstellt eine OleDbDataReader mithilfe einer der der CommandBehavior Werte.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird.Executes the query, and returns the first column of the first row in the result set returned by the query. Zusätzliche Spalten oder Zeilen werden ignoriert.Additional columns or rows are ignored.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() 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.

ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout()

Setzt die CommandTimeout Eigenschaft auf den Standardwert.Resets the CommandTimeout property to the default value.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen dieser 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.

(Inherited from Component)

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

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

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

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

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

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

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

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

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch