IDbCommand Gränssnitt

Definition

public interface class IDbCommand : IDisposable

public interface IDbCommand : IDisposable

type IDbCommand = interface
    interface IDisposable

Public Interface IDbCommand
Implements IDisposable

Härledda

System.Data.Common.DbCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Implementeringar

IDisposable

Exempel

I följande exempel skapas instanser av de härledda klasserna , SqlConnection, SqlCommandoch SqlDataReader. Exemplet läser igenom data och skriver dem till konsolen. Slutligen stänger SqlDataReaderexemplet , och sedan 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

Kommentarer

Gränssnittet IDbCommand gör det möjligt för en ärvande klass att implementera en kommandoklass, som representerar en SQL-instruktion som körs i en datakälla. Mer information om kommandoklasser finns i Köra ett kommando.

Ett program skapar inte en instans av IDbCommand gränssnittet direkt, men skapar en instans av en klass som implementerar IDbCommand gränssnittet.

Klasser som implementerar IDbCommand måste implementera alla sina medlemmar och vanligtvis definiera ytterligare medlemmar för att lägga till providerspecifika funktioner. Gränssnittet definierar IDbCommand till exempel ExecuteNonQuery metoden. Klassen ärver i sin tur den SqlCommand här metoden och definierar ExecuteXmlReader även metoden.

Anteckningar till implementerare

Om du vill främja konsekvens mellan .NET Framework-dataprovidrar namnger du ärvningsklassen i formuläret PrvClassname där Prv är det enhetliga prefix som ges till alla klasser i ett specifikt .NET Framework-dataprovidernamnområde. Är till exempel Sql prefixet för SqlCommand klassen i System.Data.SqlClient namnområdet.

När du ärver från IDbCommand gränssnittet bör du implementera följande konstruktorer:

Se även

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand