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 que acceden a bases de datos relacionales.

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. En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra ySqlDataReader, a continuación, .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 que una clase heredada implemente una clase Command, que representa una instrucción SQL que se ejecuta en un origen de datos. Para obtener más información sobre las clases Command, vea Ejecución de un comando.

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 .

Las clases que implementan IDbCommand deben implementar todos sus miembros y normalmente definir miembros adicionales para agregar funcionalidad específica del proveedor. Por ejemplo, la IDbCommand interfaz define el ExecuteNonQuery método . A su vez, la SqlCommand clase hereda este método y también define el ExecuteXmlReader método .

Notas a los implementadores

Para promover la coherencia entre los proveedores de datos de .NET Framework, asigne un nombre a la clase heredada en el formulario PrvClassname donde Prv es el prefijo uniforme proporcionado a todas las clases de un espacio de nombres específico del proveedor de datos de .NET Framework. Por ejemplo, Sql es el prefijo de la SqlCommand clase en el System.Data.SqlClient espacio de nombres .

Al heredar de la IDbCommand interfaz, debe implementar los siguientes constructores:

Elemento Descripción
PrvCommand() Inicializa una nueva instancia de la clase PrvCommand.
PrvCommand(string cmdText) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta.
PrvCommand(string cmdText, PrvConnection connection) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta y prvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta, prvConnection y PrvTransaction.

Propiedades

CommandText

Obtiene o establece el comando de texto para ejecutar con el origen de datos.

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.

CommandType

Indica o especifica cómo se interpreta la propiedad CommandText .

Connection

Obtiene o establece la interfaz IDbConnection que usa esta instancia de IDbCommand.

Parameters

Obtiene la estructura IDataParameterCollection.

Transaction

Obtiene o establece la transacción dentro de la cual se ejecuta el objeto Command de un proveedor de datos de .NET.

UpdatedRowSource

Obtiene o establece la manera en que se aplican los resultados a DataRow cuando lo utiliza el método Update(DataSet) de DbDataAdapter.

Métodos

Cancel()

Intenta cancelar la ejecución de IDbCommand.

CreateParameter()

Crea una nueva instancia de un objeto IDbDataParameter .

Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.

(Heredado de IDisposable)
ExecuteNonQuery()

Ejecuta una instrucción SQL contra el objeto Connection de un proveedor de datos .NET y devuelve el número de filas afectadas.

ExecuteReader()

Ejecuta CommandText contra Connection y genera IDataReader.

ExecuteReader(CommandBehavior)

Ejecuta CommandText contra Connection y genera IDataReader mediante uno de los valores de CommandBehavior.

ExecuteScalar()

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Las columnas o filas adicionales no se tienen en cuenta.

Prepare()

Crea una versión preparada (o compilada) del comando en el origen de datos.

Se aplica a

Consulte también