IDbCommand Interfaz

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 derivadas, SqlConnection, SqlCommandy SqlDataReader.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. Por último, en el ejemplo se cierra el SqlDataReadery, a continuación, el 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

Comentarios

La interfaz IDbCommand permite a una clase heredada implementar una clase Command, 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 interfaz IDbCommand directamente, sino que crea una instancia de una clase que implementa la interfaz 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.

Las clases que implementan IDbCommand 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 interfaz IDbCommand define el método ExecuteNonQuery.For example, the IDbCommand interface defines the ExecuteNonQuery method. A su vez, la clase SqlCommand hereda este método y también define el método ExecuteXmlReader.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 heredada el nombre PrvClassname donde Prv es el prefijo uniforme dado a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico.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 la clase SqlCommand en el espacio de nombres System.Data.SqlClient.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Cuando herede de la interfaz IDbCommand, 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

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

CommandTimeout

Obtiene o establece el tiempo de espera (en segundos) hasta que se interrumpe el intento de ejecutar un comando y se genera un error.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

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

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

Obtiene la IDataParameterCollection.Gets the IDataParameterCollection.

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

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()

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

CreateParameter()

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

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.

(Heredado de IDisposable)
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()

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

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()

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()

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: