Sdílet prostřednictvím


IDbCommand Rozhraní

Definice

Představuje příkaz SQL, který se provádí při připojení ke zdroji dat a je implementován zprostředkovateli dat .NET, kteří přistupují k relačním databázím.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Odvozené
Implementuje

Příklady

Následující příklad vytvoří instance odvozených tříd , SqlConnectionSqlCommanda SqlDataReader. Příklad přečte data a zapíše je do konzoly. Nakonec příklad zavře SqlDataReadera pak 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

Poznámky

Rozhraní IDbCommand umožňuje zděděné třídě implementovat třídu Command, která představuje příkaz SQL, který se provádí ve zdroji dat. Další informace o command třídách najdete v tématu Provádění příkazu.

Aplikace nevytvoří instanci IDbCommand rozhraní přímo, ale vytvoří instanci třídy, která implementuje IDbCommand rozhraní.

Třídy, které implementují IDbCommand , musí implementovat všechny své členy a obvykle definovat další členy pro přidání funkcí specifických pro zprostředkovatele. Rozhraní například IDbCommand definuje metodu ExecuteNonQuery . Naopak třída dědí tuto metodu SqlCommand a také definuje metodu ExecuteXmlReader .

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .NET Framework, pojmenujte dědící třídu ve formátu PrvClassname , kde Prv je jednotná předpona přidělená všem třídám v určitém oboru názvů zprostředkovatele dat rozhraní .NET Framework. Je například Sql předponou SqlCommand třídy v System.Data.SqlClient oboru názvů.

Při dědění z IDbCommand rozhraní byste měli implementovat následující konstruktory:

Položka Popis
PrvCommand() Inicializuje novou instanci PrvCommand třídy.
PrvCommand(string cmdText) Inicializuje novou instanci PrvCommand třídy s textem dotazu.
PrvCommand(string cmdText, PrvConnection connection) Inicializuje novou instanci PrvCommand třídy s textem dotazu a PrvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inicializuje novou instanci PrvCommand třídy s textem dotazu, PrvConnection a PrvTransaction.

Vlastnosti

CommandText

Získá nebo nastaví příkaz text pro spuštění proti zdroji dat.

CommandTimeout

Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění příkazu a generování chyby.

CommandType

Označuje nebo určuje, jak CommandText je vlastnost interpretována.

Connection

Získá nebo nastaví použitou IDbConnection touto instancí objektu IDbCommand.

Parameters

Získá .IDataParameterCollection

Transaction

Získá nebo nastaví transakci, ve které Command objekt zprostředkovatele dat .NET provede.

UpdatedRowSource

Získá nebo nastaví způsob použití výsledků DataRow příkazu při použití Update(DataSet) metodou DbDataAdapter.

Metody

Cancel()

Pokusí se zrušit spuštění objektu IDbCommand.

CreateParameter()

Vytvoří novou instanci objektu IDbDataParameter .

Dispose()

Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků.

(Zděděno od IDisposable)
ExecuteNonQuery()

Spustí příkaz SQL proti objektu Connection zprostředkovatele dat .NET a vrátí počet ovlivněných řádků.

ExecuteReader()

Spustí proti CommandTextConnection a vytvoří IDataReader.

ExecuteReader(CommandBehavior)

Spustí proti CommandTextConnectiona vytvoří IDataReader objekt pomocí jedné z CommandBehavior hodnot.

ExecuteScalar()

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácené dotazem. Nadbytečné sloupce nebo řádky se ignorují.

Prepare()

Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.

Platí pro

Viz také