IDbCommand IDbCommand IDbCommand IDbCommand Interface

Definition

Stellt eine SQL-Anweisung dar, die während der Verbindung mit einer Datenquelle ausgeführt wird, und wird von den .NET Framework-Datenanbietern implementiert, 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 der abgeleiteten Klassen, SqlConnection SqlCommand, und SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben.The example reads through the data, writing it to the console. Schließlich schließt das Beispiel den SqlDataReader, dann die. SqlConnectionFinally, 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 es einer erbenden Klasse, eine Befehls Klasse zu implementieren, die eine SQL-Anweisung darstellt, die in 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 Befehls Klassen finden Sie unter Ausführen eines Befehls.For more information about Command classes, see Executing a Command.

Eine Anwendung erstellt keine direkte Instanz der IDbCommand -Schnittstelle, sondern erstellt eine Instanz einer Klasse, die die IDbCommand -Schnittstelle implementiert.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, die IDbCommand implementieren, müssen alle zugehörigen Member implementieren und in der Regel zusätzliche Elemente definieren, um anbieterspezifische Funktionen hinzuzufügen.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Die IDbCommand -Schnittstelle definiert z. ExecuteNonQuery b. die-Methode.For example, the IDbCommand interface defines the ExecuteNonQuery method. Wiederum erbt die SqlCommand -Klasse diese 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

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse PrvClassname in Prv der Form, wobei das einheitliche Präfix ist, das für alle Klassen in einem bestimmten .NET Framework Datenanbieter-Namespace angegeben wird.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. Beispielsweise Sql ist das Präfix SqlCommand der-Klasse im System.Data.SqlClient -Namespace.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

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

ElementItem BeschreibungDescription
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-cmdtext, PrvConnection-Verbindung)PrvCommand(string cmdText, PrvConnection connection) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage und einer PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.
PrvCommand (String-cmdtext, PrvConnection-Verbindung, 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.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 für die Datenquelle auszuführenden Textbefehl ab bzw. legt ihn 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 bzw. legt fest, 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 das 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-Datenanbieters 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 den 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