IDbCommand Schnittstelle

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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
IDisposable

Beispiele

Im folgenden Beispiel werden Instanzen der abgeleiteten Klassen SqlConnection, SqlCommandund SqlDataReadererstellt. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben. Schließlich schließt das Beispiel , SqlDataReaderund dann die 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 Command-Klasse zu implementieren, die eine SQL-Anweisung darstellt, die in einer Datenquelle ausgeführt wird. Weitere Informationen zu Command-Klassen finden Sie unter Ausführen eines Befehls.

Eine Anwendung erstellt nicht direkt eine instance der IDbCommand Schnittstelle, sondern eine instance einer Klasse, die die IDbCommand -Schnittstelle implementiert.

Klassen, die implementieren IDbCommand , müssen alle member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Beispielsweise definiert die IDbCommand -Schnittstelle die ExecuteNonQuery -Methode. Die -Klasse wiederum SqlCommand erbt 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 der FormPrvClassname, wobei Prv das einheitliche Präfix ist, das allen Klassen in einem bestimmten .NET Framework-Datenanbieternamespace zugewiesen wird. Beispielsweise Sql ist 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 instance der PrvCommand-Klasse.
PrvCommand(string cmdText) Initialisiert eine neue instance der PrvCommand-Klasse mit dem Text der Abfrage.
PrvCommand(string cmdText, PrvConnection-Verbindung) Initialisiert eine neue instance der PrvCommand-Klasse mit dem Text der Abfrage und einer PrvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Initialisiert eine neue instance 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:

Weitere Informationen