DbCommand Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.dll

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 : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable

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

Constructores

Nombre	Description
DbCommand()	Construye una instancia del DbCommand objeto .

Propiedades

Nombre	Description
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 CommandText propiedad.
Connection	Obtiene o establece el DbConnection objeto utilizado por este DbCommandobjeto .
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
DbConnection	Obtiene o establece el DbConnection objeto utilizado por este DbCommandobjeto .
DbParameterCollection	Obtiene la colección de DbParameter objetos .
DbTransaction	Obtiene o establece el objeto en el DbTransaction que se ejecuta este DbCommand objeto.
DesignMode	Obtiene un valor que indica si Component el objeto 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 Componentobjeto . (Heredado de Component)
Parameters	Obtiene la colección de DbParameter objetos . Para obtener 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 el objeto en el DbTransaction que se ejecuta este DbCommand objeto.
UpdatedRowSource	Obtiene o establece cómo se aplican los resultados del comando al DataRow cuando lo usa el método Update de .DbDataAdapter

Métodos

Nombre	Description
Cancel()	Intenta cancelar la ejecución de .DbCommand
CreateDbParameter()	Crea una nueva instancia de un DbParameter objeto .
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 DbParameter objeto .
Dispose()	Libera todos los recursos usados por .Component (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados utilizados por Component y, opcionalmente, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Ejecuta el comando en su conexión y devuelve 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 sincrónico ExecuteReader() 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. ExecuteNonQueryAsync(CancellationToken) Invoca 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 sincrónico ExecuteNonQuery() 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 DbCommand objeto hasta que se complete la tarea devuelta.
ExecuteReader()	Ejecuta el comando en su conexión y devuelve un DbDataReader que se puede usar para acceder a los resultados.
ExecuteReader(CommandBehavior)	Ejecuta el comando en su conexión y devuelve 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. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Invoca 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. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
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. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
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. ExecuteScalarAsync(CancellationToken) Invoca 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 sincrónico ExecuteScalar() 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 DbCommand objeto hasta que se complete la tarea devuelta.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	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 Component o por su Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	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 actual MarshalByRefObject . (Heredado de MarshalByRefObject)
Prepare()	Crea una versión preparada (o compilada) del comando en el origen de datos.
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)

Implementaciones de interfaz explícitas

Nombre	Description
IDbCommand.Connection	Obtiene o establece el IDbConnection objeto utilizado por esta instancia de .IDbCommand
IDbCommand.CreateParameter()	Crea una nueva instancia de un IDbDataParameter objeto .
IDbCommand.ExecuteReader()	Ejecuta en CommandText y Connection compila un IDataReaderobjeto .
IDbCommand.ExecuteReader(CommandBehavior)	Ejecuta en CommandTextConnectiony compila mediante IDataReader uno de los CommandBehavior valores .
IDbCommand.Parameters	Obtiene IDataParameterCollection.
IDbCommand.Transaction	Obtiene o establece el objeto en el DbTransaction que se ejecuta este DbCommand objeto.

Consulte también

• Información general de ADO.NET