IDbCommand Интерфейс

Определение

public interface class IDbCommand : IDisposable

public interface IDbCommand : IDisposable

type IDbCommand = interface
    interface IDisposable

Public Interface IDbCommand
Implements IDisposable

Производный

System.Data.Common.DbCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Реализации

IDisposable

Примеры

В следующем примере создаются экземпляры производных классов , SqlConnectionSqlCommandи SqlDataReader. В этом примере данные считываются, записывая их в консоль. Наконец, пример закрывает SqlDataReader, а затем .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

Комментарии

Интерфейс IDbCommand позволяет наследуемому классу реализовать класс Command, который представляет инструкцию SQL, выполняемую в источнике данных. Дополнительные сведения о классах Command см. в разделе Выполнение команды.

Приложение не создает экземпляр IDbCommand интерфейса напрямую, а создает экземпляр класса, реализующего IDbCommand интерфейс .

Классы, реализующие IDbCommand , должны реализовывать все свои члены и, как правило, определять дополнительные члены для добавления функциональных возможностей, зависящих от поставщика. Например, IDbCommand интерфейс определяет ExecuteNonQuery метод . В свою очередь, класс наследует SqlCommand этот метод, а также определяет ExecuteXmlReader метод .

Примечания для тех, кто реализует этот метод

Чтобы повысить согласованность между поставщиками данных платформа .NET Framework, назовите наследующий класс в том видеPrvClassname, где Prv является универсальным префиксом, предоставленным всем классам в определенном платформа .NET Framework пространстве имен поставщика данных. Например, Sql — это префикс SqlCommand класса в System.Data.SqlClient пространстве имен .

При наследовании от IDbCommand интерфейса необходимо реализовать следующие конструкторы:

См. также раздел

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand