DbCommand Clase

Referencia

Definición

Espacio de nombres:: System.Data.Common

Ensamblado:: System.Data.Common.dll

Ensamblado:: System.Data.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa una instrucción SQL o un procedimiento almacenado que se van a ejecutar en un origen de datos. Proporciona una clase base para las 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: Object
DbCommand

Herencia: Object

MarshalByRefObject

Component
DbCommand

Derivado: System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Implementaciones: IDisposable IDbCommand IAsyncDisposable

Constructores

DbCommand()

Genera 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 para ejecutar con 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 CommandText propiedad.
Connection	Obtiene o establece el objeto DbConnection utilizado por este DbCommand.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DbConnection	Obtiene o establece el objeto DbConnection utilizado por este DbCommand.
DbParameterCollection	Obtiene la colección de objetos DbParameter.
DbTransaction	Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand.
DesignMode	Obtiene un valor que indica si 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 asociados a Component. (Heredado de Component)
Parameters	Obtiene la colección de objetos DbParameter. Para más información sobre los parámetros, vea Configurar parámetros y tipos de datos de parámetros.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Transaction	Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand.
UpdatedRowSource	Obtiene o establece cómo se aplican los resultados de un comando al objeto DataRow cuando lo utiliza el método Update de un objeto DbDataAdapter.

Métodos

Cancel()	Intenta cancelar la ejecución de un objeto DbCommand.
CreateDbParameter()	Crea una nueva instancia de un objeto DbParameter.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado 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 o al restablecimiento de recursos no administrados.
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa DbCommand y, de forma opcional, libera los recursos administrados.
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
DisposeAsync()	Desecha de forma asincrónica el objeto de comando.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para tener acceso a los resultados.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Los proveedores deben implementar este método para proporcionar una implementación no predeterminada para las sobrecargas de ExecuteReader. La implementación predeterminada invoca el método sincrónico ExecuteReader() y devuelve una tarea completada, bloqueando el subproceso de 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 mediante la propiedad Task Exception devuelta. Este método acepta un token de cancelación que se puede usar para solicitar que la operación se cancele pronto. 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 lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso de 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 mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto `DbCommand` hasta que se haya completado la tarea devuelta.
ExecuteReader()	Ejecuta el comando en su conexión y devuelve un DbDataReader objeto que se puede usar para tener acceso a los resultados.
ExecuteReader(CommandBehavior)	Ejecuta el comando en su conexión y devuelve un DbDataReader objeto que se puede usar para tener acceso a los resultados.
ExecuteReaderAsync()	Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, que devuelve un DbDataReader objeto 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, que devuelve un DbDataReader objeto 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, que devuelve un DbDataReader objeto 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. Todas las demás columnas, filas y conjuntos de resultados se omiten.
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. Todas las demás columnas, filas y conjuntos de resultados se omiten. Invoca ExecuteScalarAsync(CancellationToken) con CancellationToken.None.
ExecuteScalarAsync(CancellationToken)	Esta es la versión asincrónica de ExecuteScalar(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso de 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 mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto `DbCommand` hasta que se haya completado la tarea devuelta.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoleto. 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 el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoleto. 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 Object actual. (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 una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().

(Heredado de Component)

Implementaciones de interfaz explícitas

IDbCommand.Connection	Obtiene o establece la interfaz IDbConnection que usa esta instancia de IDbCommand.
IDbCommand.CreateParameter()	Crea una nueva instancia de un objeto IDbDataParameter .
IDbCommand.ExecuteReader()	Ejecuta CommandText contra Connection y genera IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Ejecuta CommandText contra Connection y genera IDataReader mediante uno de los valores de CommandBehavior.
IDbCommand.Parameters	Obtiene la estructura IDataParameterCollection.
IDbCommand.Transaction	Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.

Se aplica a

Consulte también

Información general sobre ADO.NET