IDbCommand Interfaz

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Representa una instrucción SQL que se ejecuta mientras está conectada a un origen de datos y se implementa mediante .NET proveedores de datos 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
IDisposable

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 constructores siguientes:

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, conexión PrvConnection) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta y prvConnection.
PrvCommand(string cmdText, conexión PrvConnection, transacción PrvTransaction) Inicializa una nueva instancia de la clase PrvCommand con el texto de la consulta, prvConnection y PrvTransaction.

Propiedades

Nombre Description
CommandText

Obtiene o establece el comando de texto que se va a ejecutar en el origen de datos.
CommandTimeout

Obtiene o establece el tiempo de espera (en segundos) antes de terminar el intento de ejecutar un comando y generar un error.
CommandType

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

Obtiene o establece el IDbConnection objeto utilizado por esta instancia de .IDbCommand
Parameters

Obtiene IDataParameterCollection.
Transaction

Obtiene o establece la transacción en la que se ejecuta el objeto Command de un proveedor de datos de .NET.
UpdatedRowSource

Obtiene o establece cómo se aplican los resultados del comando al DataRow cuando se usa en el Update(DataSet) método de .DbDataAdapter

Métodos

Nombre Description
Cancel()

Intenta cancelar la ejecución de un IDbCommandobjeto .
CreateParameter()

Crea una nueva instancia de un IDbDataParameter objeto .
Dispose()

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

(Heredado de IDisposable)
ExecuteNonQuery()

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

Ejecuta en CommandText y Connection compila un IDataReaderobjeto .
ExecuteReader(CommandBehavior)

Ejecuta en CommandTextConnectiony compila mediante IDataReader uno de los CommandBehavior valores .
ExecuteScalar()

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Se omiten las columnas o filas adicionales.
Prepare()

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

Se aplica a

Consulte también