IDbCommand IDbCommand IDbCommand IDbCommand Interface

Definición

Representa una instrucción SQL que se ejecuta mientras hay conexión con un origen de datos y se implementa mediante proveedores de datos .NET Framework que acceden a bases de datos relacionales.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
Derivado
Implementaciones

Ejemplos

En el ejemplo siguiente se crean instancias de las clases SqlConnectionderivadas, SqlDataReader SqlCommand, y.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. En el ejemplo se leen los datos y se escriben en la consola.The example reads through the data, writing it to the console. Finalmente, el ejemplo cierra SqlDataReadery, a continuación, el. SqlConnectionFinally, 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

Comentarios

La IDbCommand interfaz permite a una clase heredada implementar una clase de comando, que representa una instrucción SQL que se ejecuta en un origen de datos.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Para obtener más información sobre las clases de comandos, vea ejecutar un comando.For more information about Command classes, see Executing a Command.

Una aplicación no crea una instancia de la IDbCommand interfaz directamente, sino que crea una instancia de una clase que implementa la IDbCommand interfaz.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

Las clases que IDbCommand implementan deben implementar todos sus miembros y, normalmente, definir miembros adicionales para agregar funcionalidad específica del proveedor.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Por ejemplo, la IDbCommand interfaz define el ExecuteNonQuery método.For example, the IDbCommand interface defines the ExecuteNonQuery method. A su vez, SqlCommand la clase hereda este método y también define el ExecuteXmlReader método.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Notas a los implementadores

Para promover la coherencia entre .NET Framework proveedores de datos, asigne a la clase PrvClassname heredada el nombre, donde Prv es el prefijo uniforme dado a todas las clases de un espacio de nombres específico del proveedor de datos de .NET Framework.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. Por ejemplo, Sql es el prefijo de SqlCommand la clase en System.Data.SqlClient el espacio de nombres.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Al heredar de la IDbCommand interfaz, debe implementar los siguientes constructores:When you inherit from the IDbCommand interface, you should implement the following constructors:

ElementoItem DescripciónDescription
PrvCommand()PrvCommand() Inicializa una nueva instancia de la clase PrvCommand.Initializes a new instance of the PrvCommand class.

PrvCommand (cadena cmdText)PrvCommand(string cmdText) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta.Initializes a new instance of the PrvCommand class with the text of the query.

PrvCommand (cadena cmdText, conexión PrvConnection)PrvCommand(string cmdText, PrvConnection connection) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta y un PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.

PrvCommand (cadena cmdText, conexión PrvConnection, transacción PrvTransaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta, un PrvConnection y PrvTransaction.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Propiedades

CommandText CommandText CommandText CommandText

Obtiene o establece el comando de texto para ejecutar con el origen de datos.Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un comando y generar un error.Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

Indica o especifica cómo se interpreta la propiedad CommandText .Indicates or specifies how the CommandText property is interpreted.

Connection Connection Connection Connection

Obtiene o establece la interfaz IDbConnection que usa esta instancia de IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters Parameters Parameters Parameters

Obtiene la estructura IDataParameterCollection.Gets the IDataParameterCollection.

Transaction Transaction Transaction Transaction

Obtiene o establece la transacción dentro de la cual se ejecuta el objeto Command de un proveedor de datos .NET Framework.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Obtiene o establece la manera en que se aplican los resultados a DataRow cuando lo utiliza el método Update(DataSet) de DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Métodos

Cancel() Cancel() Cancel() Cancel()

Intenta cancelar la ejecución de IDbCommand.Attempts to cancels the execution of an IDbCommand.

CreateParameter() CreateParameter() CreateParameter() CreateParameter()

Crea una nueva instancia de un objeto IDbDataParameter .Creates a new instance of an IDbDataParameter object.

Dispose() Dispose() Dispose() Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from IDisposable)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Ejecuta una instrucción SQL contra el objeto Connection de un proveedor de datos .NET Framework y devuelve el número de filas afectadas.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Ejecuta CommandText contra Connection y genera IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Ejecuta CommandText contra Connection y genera IDataReader mediante uno de los valores de CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta.Executes the query, and returns the first column of the first row in the resultset returned by the query. Las columnas o filas adicionales no se tienen en cuenta.Extra columns or rows are ignored.

Prepare() Prepare() Prepare() Prepare()

Crea una versión preparada (o compilada) del comando en el origen de datos.Creates a prepared (or compiled) version of the command on the data source.

Se aplica a

Consulte también: