IDbCommand Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDbCommand.cs

Představuje příkaz SQL, který se spustí při připojení ke zdroji dat a implementuje zprostředkovatelé 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é

System.Data.Common.DbCommand

System.Data.OleDb.OleDbCommand

Implementuje

IDisposable

Příklady

Následující příklad vytvoří instance odvozených tříd, SqlConnection, SqlCommand, a SqlDataReader. Příklad čte data a zapisuje je do konzoly. Nakonec příklad zavře SqlDataReader, a 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ěnou třídu implementovat třídu Command, která představuje příkaz SQL, který se spouští ve zdroji dat. Další informace o třídách příkazů naleznete v tématu Spuštění příkazu.

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

Třídy, které implementují IDbCommand , musí implementovat všechny jeho členy a obvykle definují další členy pro přidání funkcí specifických pro zprostředkovatele. Rozhraní například IDbCommand definuje metodu ExecuteNonQuery . Třída zase SqlCommand dědí tuto metodu 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ění třídy ve formuláři PrvClassname , kde Prv je uniformní předpona udělená všem třídám v konkrétním oboru názvů zprostředkovatele dat rozhraní .NET Framework. Například Sql je předpona 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 Třídy PrvCommand.
PrvCommand(string cmdText)	Inicializuje novou instanci Třídy PrvCommand s textem dotazu.
PrvCommand(řetězec cmdText, připojení PrvConnection)	Inicializuje novou instanci Třídy PrvCommand s textem dotazu a PrvConnection.
PrvCommand(string cmdText, PrvConnection připojení, Transakce PrvTransaction)	Inicializuje novou instanci Třídy PrvCommand s textem dotazu, PrvConnection a PrvTransaction.

Vlastnosti

Name	Description
CommandText	Získá nebo nastaví textový příkaz ke spuštění ve 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 způsob CommandText interpretace vlastnosti.
Connection	Získá nebo nastaví IDbConnection používané touto instancí IDbCommand.
Parameters	IDataParameterCollectionZíská .
Transaction	Získá nebo nastaví transakce, ve které Command objekt .NET zprostředkovatel dat spustí.
UpdatedRowSource	Získá nebo nastaví způsob použití výsledků DataRow příkazu při použití Update(DataSet) metodou DbDataAdapter.

Metody

Name	Description
Cancel()	Pokusy o zrušení spuštění .IDbCommand
CreateParameter()	Vytvoří novou instanci objektu IDbDataParameter .
Dispose()	Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od IDisposable)
ExecuteNonQuery()	Spustí příkaz SQL na objektu Connection zprostředkovatele dat .NET a vrátí počet ovlivněných řádků.
ExecuteReader()	Provede proti CommandTextConnection a sestaví IDataReader.
ExecuteReader(CommandBehavior)	Provede proti objektu CommandTextConnectiona vytvoří IDataReader pomocí jedné z CommandBehavior hodnot.
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácených dotazem. Nadbytečné sloupce nebo řádky se ignorují.
Prepare()	Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.

Viz také

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand