IDbCommand IDbCommand IDbCommand IDbCommand Interface

Definition

Stellt eine SQL-Anweisung dar, die während einer Verbindung mit einer Datenquelle ausgeführt wird. Die Implementierung erfolgt durch .NET Framework-Datenprovider, die auf relationale Datenbanken zugreifen.Represents an SQL statement that is executed while connected to a data source, and is implemented by .NET Framework data providers that access relational databases.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Abgeleitet
Implementiert

Beispiele

Das folgende Beispiel erstellt Instanzen von abgeleiteten Klassen, SqlConnection, SqlCommand, und SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. Im Beispiel liest die Daten, die sie an die Konsole geschrieben.The example reads through the data, writing it to the console. Zum Schluss das Beispiel schließt den SqlDataReader, und klicken Sie dann die SqlConnection.Finally, the example closes the SqlDataReader, then the SqlConnection.

private static void ReadOrderData(string connectionString)
{
    string queryString = 
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}
Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Hinweise

Die IDbCommand Schnittstelle ermöglicht eine erbende Klasse zum Implementieren einer Command-Klasse, eine SQL-Anweisung darstellt, die an einer Datenquelle ausgeführt wird.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Weitere Informationen zu Befehlsklassen, finden Sie unter Ausführen eines Befehls.For more information about Command classes, see Executing a Command.

Eine Anwendung erstellt eine Instanz der keine der IDbCommand -Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die implementiert die IDbCommand Schnittstelle.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

Klassen, in denen IDbCommand müssen Sie alle ihre Member implementieren und definieren Sie in der Regel zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Z. B. die IDbCommand Schnittstelle definiert die ExecuteNonQuery Methode.For example, the IDbCommand interface defines the ExecuteNonQuery method. Im Gegenzug die SqlCommand Klasse erbt von dieser Methode und definiert auch die ExecuteXmlReader Methode.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Hinweise für Ausführende

Benennen Sie die erbende Klasse in das Formular zur Förderung der Konsistenz zwischen .NET Framework-Datenanbieter PrvClassname , in denen Prv ist das einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework Data Provider-Namespace.To promote consistency among .NET Framework data providers, name the inheriting class in the form PrvClassname where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Z. B. Sql ist das Präfix der der SqlCommand -Klasse in der System.Data.SqlClient Namespace.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Beim Erben von der IDbCommand -Schnittstelle, implementieren Sie die folgenden Konstruktoren:When you inherit from the IDbCommand interface, you should implement the following constructors:

ElementItem Beschreibung Description
PrvCommand()PrvCommand() Initialisiert eine neue Instanz der PrvCommand-Klasse.Initializes a new instance of the PrvCommand class.

PrvCommand(string cmdText)PrvCommand(string cmdText) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage.Initializes a new instance of the PrvCommand class with the text of the query.

PrvCommand (String Befehlstext, PrvConnection Verbindung)PrvCommand(string cmdText, PrvConnection connection) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage und einer PrvConnection an.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.

PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage, einer PrvConnection und der PrvTransaction an.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Eigenschaften

CommandText CommandText CommandText CommandText

Ruft den Textbefehl ab, der für die Datenquelle ausgeführt werden soll, oder legt diesen fest.Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Ruft die Zeit 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 before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

Gibt an, wie die CommandText-Eigenschaft interpretiert wird.Indicates or specifies how the CommandText property is interpreted.

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

Parameters Parameters Parameters Parameters

Ruft die IDataParameterCollection ab.Gets the IDataParameterCollection.

Transaction Transaction Transaction Transaction

Ruft die Transaktion ab, in der das Command-Objekt eines .NET Framework-Datenproviders ausgeführt wird, oder legt diese fest.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Ruft ab oder legt fest, wie die Ergebnisse von Befehlen auf DataRow angewendet werden, wenn diese von der Update(DataSet)-Methode eines DbDataAdapter verwendet werden.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Methoden

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

Versucht die Ausführung eines IDbCommand abzubrechen.Attempts to cancels the execution of an IDbCommand.

CreateParameter() CreateParameter() CreateParameter() CreateParameter()

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

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

(Inherited from IDisposable)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Führt eine SQL-Anweisung für das Connection-Objekt eines .NET Framework-Datenproviders aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

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

Führt CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) 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.

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 resultset returned by the query. Zusätzliche Spalten oder Zeilen werden ignoriert.Extra columns or rows are ignored.

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.

Gilt für:

Siehe auch