Compartir a través de


DbCommand Clase

Definición

Representa una instrucción SQL o un procedimiento almacenado que se ejecutarán en un origen de datos. Proporciona una clase base para clases específicas de la base de datos que representan comandos. ExecuteNonQueryAsync.

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
type DbCommand = class
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Herencia
DbCommand
Herencia
Derivado
Implementaciones

Constructores

DbCommand()

Construye una instancia del objeto DbCommand.

Propiedades

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.

(Heredado de Component)
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 finalizar el intento de ejecutar el comando y generar un error.

CommandType

Obtiene o establece cómo se interpreta la propiedad CommandText.

Connection

Obtiene o establece el DbConnection usado por este DbCommand.

Container

Obtiene el IContainer que contiene el Component.

(Heredado de Component)
DbConnection

Obtiene o establece el DbConnection usado por este DbCommand.

DbParameterCollection

Obtiene la colección de objetos DbParameter.

DbTransaction

Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbCommand.

DesignMode

Obtiene un valor que indica si el Component está actualmente en modo de diseño.

(Heredado de Component)
DesignTimeVisible

Obtiene o establece un valor que indica si el objeto de comando debe estar visible en un control de interfaz personalizado.

Events

Obtiene la lista de controladores de eventos que están asociados a este Component.

(Heredado de Component)
Parameters

Obtiene la colección de objetos DbParameter. Para obtener más información sobre los parámetros, vea Configuración de parámetros y tipos de datos de parámetros.

Site

Obtiene o establece el ISite del Component.

(Heredado de Component)
Transaction

Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbCommand.

UpdatedRowSource

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

Métodos

Cancel()

Intenta cancelar la ejecución de un DbCommand.

CreateDbParameter()

Crea una nueva instancia de un objeto DbParameter.

CreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
CreateParameter()

Crea una nueva instancia de un objeto DbParameter.

Dispose()

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

Dispose()

Libera todos los recursos usados por el Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados usados por el DbCommand y, opcionalmente, libera los recursos administrados.

Dispose(Boolean)

Libera los recursos no administrados usados por el Component y, opcionalmente, libera los recursos administrados.

(Heredado de Component)
DisposeAsync()

De forma asincrónica se dipa el objeto de comando.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
ExecuteDbDataReader(CommandBehavior)

Ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Los proveedores deben implementar este método para proporcionar una implementación no predeterminada para ExecuteReader sobrecargas.

La implementación predeterminada invoca el método ExecuteReader() sincrónico y devuelve una tarea completada, bloqueando el subproceso que realiza la llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteReader se comunicarán a través de la propiedad Task Exception devuelta.

Este método acepta un token de cancelación que se puede usar para solicitar la cancelación anticipada de la operación. Las implementaciones pueden omitir esta solicitud.

ExecuteNonQuery()

Ejecuta el comando en su objeto de conexión y devuelve el número de filas afectadas.

ExecuteNonQueryAsync()

Una versión asincrónica de ExecuteNonQuery(), que ejecuta el comando en su objeto de conexión, devolviendo el número de filas afectadas.

Invoca ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteNonQuery(). Los proveedores deben invalidar con una implementación adecuada. El token de cancelación puede omitirse opcionalmente.

La implementación predeterminada invoca el método ExecuteNonQuery() sincrónico y devuelve una tarea completada, bloqueando el subproceso que realiza la llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteNonQuery() se comunicarán a través de la propiedad Task Exception devuelta.

No invoque otros métodos y propiedades del objeto DbCommand hasta que se complete la tarea devuelta.

ExecuteReader()

Ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

ExecuteReader(CommandBehavior)

Ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

ExecuteReaderAsync()

Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None.

ExecuteReaderAsync(CancellationToken)

Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

Ejecuta el comando y devuelve la primera columna de la primera fila del primer conjunto de resultados devuelto. Se omiten todas las demás columnas, filas y conjuntos de resultados.

ExecuteScalarAsync()

Una versión asincrónica de ExecuteScalar(), que ejecuta el comando y devuelve la primera columna de la primera fila del primer conjunto de resultados devuelto. Se omiten todas las demás columnas, filas y conjuntos de resultados.

Invoca ExecuteScalarAsync(CancellationToken) con CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteScalar(). Los proveedores deben invalidar con una implementación adecuada. El token de cancelación puede omitirse opcionalmente.

La implementación predeterminada invoca el método ExecuteScalar() sincrónico y devuelve una tarea completada, bloqueando el subproceso que realiza la llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteScalar se comunicarán a través de la propiedad Task Exception devuelta.

No invoque otros métodos y propiedades del objeto DbCommand hasta que se complete la tarea devuelta.

GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
Prepare()

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

PrepareAsync(CancellationToken)

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

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
ToString()

Devuelve un String que contiene el nombre del Component, si existe. Este método no se debe invalidar.

(Heredado de Component)

Eventos

Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().

(Heredado de Component)

Implementaciones de interfaz explícitas

IDbCommand.Connection

Obtiene o establece el IDbConnection usado por esta instancia del IDbCommand.

IDbCommand.CreateParameter()

Crea una nueva instancia de un objeto IDbDataParameter.

IDbCommand.ExecuteReader()

Ejecuta el CommandText en el Connection y compila un IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Ejecuta el CommandText en el Connectiony compila un IDataReader mediante uno de los valores de CommandBehavior.

IDbCommand.Parameters

Obtiene el IDataParameterCollection.

IDbCommand.Transaction

Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbCommand.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Se aplica a

Consulte también

  • información general de ADO.NET