IDbCommand Schnittstelle

Definition

Stellt eine SQL-Anweisung dar, die während der Verbindung mit einer Datenquelle ausgeführt wird, und wird von den .NET-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

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

Beispiele

Im folgenden Beispiel werden Instanzen der abgeleiteten Klassen, SqlConnection, SqlCommand, und SqlDataReader. Das Beispiel liest die Daten durch, schreibt sie in die Konsole. Schließlich schließt das Beispiel den SqlDataReader, und dann den 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 geerbte Klasse zum Implementieren einer Command-Klasse, die eine SQL Anweisung darstellt, die in einer Datenquelle ausgeführt wird. Weitere Informationen zu Befehlsklassen finden Sie unter Ausführen eines Befehls.

Eine Anwendung erstellt keine Instanz der IDbCommand Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die die IDbCommand Schnittstelle implementiert.

Klassen, die implementieren IDbCommand , müssen alle Mitglieder implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Die Schnittstelle definiert beispielsweise IDbCommand die ExecuteNonQuery Methode. Wiederum erbt die SqlCommand Klasse diese Methode und definiert auch die ExecuteXmlReader Methode.

Hinweise für Ausführende

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse in dem FormularPrvClassname, wobei es sich um das einheitliche Präfix handelt, Prv das allen Klassen in einem bestimmten .NET Framework Datenanbieternamespace zugewiesen ist. Ist beispielsweise Sql das Präfix der SqlCommand Klasse im System.Data.SqlClient Namespace.

Wenn Sie von der IDbCommand Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:

Element Beschreibung
PrvCommand() Initialisiert eine neue Instanz der PrvCommand-Klasse.
PrvCommand(string cmdText) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage.
PrvCommand(string cmdText, PrvConnection connection) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage und einer PrvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Initialisiert eine neue Instanz der PrvCommand-Klasse mit dem Text der Abfrage, einer PrvConnection und der PrvTransaction.

Eigenschaften

CommandText

Ruft den für die Datenquelle auszuführenden Textbefehl ab bzw. legt ihn fest.

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.

CommandType

Gibt an bzw. legt fest, wie die CommandText-Eigenschaft interpretiert wird.

Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.

Parameters

Ruft das IDataParameterCollection ab.

Transaction

Ruft die Transaktion ab, innerhalb derer das Command-Objekt eines .NET-Datenanbieters ausgeführt wird, oder legt diese fest.

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.

Methoden

Cancel()

Versucht, die Ausführung eines IDbCommand abzubrechen.

CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter -Objekts.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

(Geerbt von IDisposable)
ExecuteNonQuery()

Führt eine SQL-Anweisung für das Connection-Objekt eines .NET-Datenanbieters aus und gibt die Anzahl der betroffenen Zeilen zurück.

ExecuteReader()

Führt den CommandText für die Connection aus und erstellt einen IDataReader.

ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.

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. Zusätzliche Spalten oder Zeilen werden ignoriert.

Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

Gilt für:

Siehe auch