IDbCommand Rozhraní

Definice

Představuje příkaz jazyka SQL, který je spuštěn během připojení ke zdroji dat a je implementován .NET Framework zprostředkovateli dat, kteří přistupují k relačním databázím.Represents an SQL statement that is executed while connected to a data source, and is implemented by .NET Framework data providers that access relational databases.

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, SqlConnection, SqlCommanda SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. Tento příklad čte data a zapisuje je do konzoly.The example reads through the data, writing it to the console. Nakonec příklad zavře SqlDataReadera pak SqlConnection.Finally, the example closes the SqlDataReader, then the 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 dědění třídy implementovat třídu příkazu, která představuje příkaz jazyka SQL, který je spuštěn ve zdroji dat.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Další informace o třídách příkazů naleznete v tématu provedení příkazu.For more information about Command classes, see Executing a Command.

Aplikace nevytváří instanci rozhraní IDbCommand přímo, ale vytvoří instanci třídy, která implementuje rozhraní IDbCommand.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

Třídy, které implementují IDbCommand musí implementovat všechny její členy a obvykle definovat další členy pro přidání funkcí specifických pro poskytovatele.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Například rozhraní IDbCommand definuje metodu ExecuteNonQuery.For example, the IDbCommand interface defines the ExecuteNonQuery method. Pak třída SqlCommand dědí tuto metodu a také definuje metodu ExecuteXmlReader.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi .NET Framework zprostředkovateli dat, pojmenujte třídu dědění ve formuláři PrvClassname kde Prv je jednotná předpona zadaná pro všechny třídy v konkrétním oboru názvů .NET Framework zprostředkovatele dat.To promote consistency among .NET Framework data providers, name the inheriting class in the form PrvClassname where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Například Sql je předpona SqlCommand třídy v oboru názvů System.Data.SqlClient.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Při dědění z rozhraní IDbCommand byste měli implementovat následující konstruktory:When you inherit from the IDbCommand interface, you should implement the following constructors:

PoložkaItem PopisDescription
PrvCommand()PrvCommand() Inicializuje novou instanci třídy PrvCommand.Initializes a new instance of the PrvCommand class.
PrvCommand (string cmdText)PrvCommand(string cmdText) Inicializuje novou instanci třídy PrvCommand textem dotazu.Initializes a new instance of the PrvCommand class with the text of the query.
PrvCommand (řetězcové cmdText, připojení PrvConnection)PrvCommand(string cmdText, PrvConnection connection) Inicializuje novou instanci třídy PrvCommand textem dotazu a PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.
PrvCommand (řetězcové cmdText, připojení PrvConnection, transakce PrvTransaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inicializuje novou instanci třídy PrvCommand textem dotazu, PrvConnection a PrvTransaction.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Vlastnosti

CommandText

Získá nebo nastaví příkaz pro text, který se má spustit proti zdroji dat.Gets or sets the text command to run against the data source.

CommandTimeout

Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění příkazu a vygenerováním chyby.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Označuje nebo určuje, jak je interpretována vlastnost CommandText.Indicates or specifies how the CommandText property is interpreted.

Connection

Získá nebo nastaví IDbConnection používané touto instancí IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters

Získá IDataParameterCollection.Gets the IDataParameterCollection.

Transaction

Získá nebo nastaví transakci, ve které se spustí objekt Command .NET Framework zprostředkovatele dat.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource

Získá nebo nastaví způsob, jakým jsou použity výsledky příkazu pro DataRow při použití metodou Update(DataSet) DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Metody

Cancel()

Pokusí se zrušit spuštění IDbCommand.Attempts to cancels the execution of an IDbCommand.

CreateParameter()

Vytvoří novou instanci objektu IDbDataParameter.Creates a new instance of an IDbDataParameter object.

Dispose()

Provádí úkoly definované aplikací, které jsou spojeny s uvolněním nebo obnovením nespravovaných prostředků.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

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

Provede příkaz SQL pro objekt Connection .NET Frameworkho poskytovatele dat a vrátí počet ovlivněných řádků.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

ExecuteReader()

Spustí CommandText proti Connection a vytvoří IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior)

Spustí CommandText proti Connectiona vytvoří IDataReader pomocí jedné z hodnot CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteScalar()

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vráceného dotazem.Executes the query, and returns the first column of the first row in the resultset returned by the query. Nadbytečné sloupce nebo řádky jsou ignorovány.Extra columns or rows are ignored.

Prepare()

Vytvoří připravenou (nebo zkompilovanou) verzi příkazu na zdroji dat.Creates a prepared (or compiled) version of the command on the data source.

Platí pro

Viz také