Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DbCommand

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Data.Common
Ensamblado:  System.Data (en System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.EntityClient.EntityCommand
        System.Data.Odbc.OdbcCommand
        System.Data.OleDb.OleDbCommand
        System.Data.OracleClient.OracleCommand
        System.Data.SqlClient.SqlCommand

public abstract class DbCommand : Component, IDbCommand, IDisposable

NombreDescripción
System_CAPS_protmethodDbCommand()

Construye una instancia de la DbCommand objeto.

NombreDescripción
System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyCommandText

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

System_CAPS_pubpropertyCommandTimeout

Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un comando y generar un error.

System_CAPS_pubpropertyCommandType

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

System_CAPS_pubpropertyConnection

Obtiene o establece el objeto DbConnection utilizado por este DbCommand.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_protpropertyDbConnection

Obtiene o establece el objeto DbConnection utilizado por este DbCommand.

System_CAPS_protpropertyDbParameterCollection

Obtiene la colección de DbParameter objetos.

System_CAPS_protpropertyDbTransaction

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

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_pubpropertyDesignTimeVisible

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

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyParameters

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

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyTransaction

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

System_CAPS_pubpropertyUpdatedRowSource

Obtiene o establece cómo se aplican los resultados del comando a la DataRow cuando se utiliza el método Update de un DbDataAdapter.

NombreDescripción
System_CAPS_pubmethodCancel()

Intenta cancelar la ejecución de un DbCommand.

System_CAPS_protmethodCreateDbParameter()

Crea una nueva instancia de un objeto DbParameter.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodCreateParameter()

Crea una nueva instancia de un objeto DbParameter.

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Heredado de Component).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodExecuteDbDataReader(CommandBehavior)

Ejecuta el texto del comando en la conexión.

System_CAPS_protmethodExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

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

La implementación predeterminada invoca sincrónico ExecuteReader método y devuelve una tarea finalizada, bloquear el subproceso que realiza la llamada. La implementación predeterminada devuelve una tarea cancelada si pasa un token de cancelación ya cancelados. Las excepciones producidas por ExecuteReader se comunicará a través de la propiedad de excepción de la tarea devuelta.

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

System_CAPS_pubmethodExecuteNonQuery()

Ejecuta una instrucción SQL en un objeto de conexión.

System_CAPS_pubmethodExecuteNonQueryAsync()

Una versión asincrónica de ExecuteNonQuery, que ejecuta una instrucción SQL en un objeto de conexión.

Invoca ExecuteNonQueryAsync con CancellationToken.None.

System_CAPS_pubmethodExecuteNonQueryAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteNonQuery. Los proveedores deberían reemplazar con una implementación apropiada. Opcionalmente, se puede omitir el token de cancelación.

La implementación predeterminada invoca sincrónico ExecuteNonQuery método y devuelve una tarea finalizada, bloquear el subproceso que realiza la llamada. La implementación predeterminada devuelve una tarea cancelada si pasa un token de cancelación ya cancelados. Las excepciones producidas por ExecuteNonQuery se comunicarán a través de la propiedad de excepción de la tarea devuelta.

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

System_CAPS_pubmethodExecuteReader()

Ejecuta el CommandText contra los Connection, y devuelve un DbDataReader.

System_CAPS_pubmethodExecuteReader(CommandBehavior)

Ejecuta el CommandText contra el Connection, y devuelve un DbDataReader mediante uno de los CommandBehavior valores.

System_CAPS_pubmethodExecuteReaderAsync()

Una versión asincrónica de ExecuteReader, que se ejecuta el CommandText contra los Connection y devuelve un DbDataReader.

Invoca ExecuteDbDataReaderAsync con CancellationToken.None.

System_CAPS_pubmethodExecuteReaderAsync(CancellationToken)

Una versión asincrónica de ExecuteReader, que se ejecuta el CommandText contra los Connection y devuelve un DbDataReader. Este método propaga una notificación de que las operaciones deberían cancelarse.

Invoca ExecuteDbDataReaderAsync.

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior)

Una versión asincrónica de ExecuteReader, que se ejecuta el CommandText contra los Connection y devuelve un DbDataReader.

Invoca ExecuteDbDataReaderAsync.

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior, CancellationToken)
System_CAPS_pubmethodExecuteScalar()

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Se omiten todas las demás columnas y filas.

System_CAPS_pubmethodExecuteScalarAsync()

Una versión asincrónica de ExecuteScalar, que ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Se omiten todas las demás columnas y filas.

Invoca ExecuteScalarAsync con CancellationToken.None.

System_CAPS_pubmethodExecuteScalarAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteScalar. Los proveedores deberían reemplazar con una implementación apropiada. Opcionalmente, se puede omitir el token de cancelación.

La implementación predeterminada invoca sincrónico ExecuteScalar método y devuelve una tarea finalizada, bloquear el subproceso que realiza la llamada. La implementación predeterminada devuelve una tarea cancelada si pasa un token de cancelación ya cancelados. Las excepciones producidas por ExecuteScalar se comunicará a través de la propiedad de excepción de la tarea devuelta.

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

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

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

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodPrepare()

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

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.CreateParameter()

Crea una nueva instancia de un objeto IDbDataParameter.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader()

Ejecuta CommandText contra Connection y genera IDataReader.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader(CommandBehavior)

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

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Connection

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

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Parameters

Obtiene la estructura IDataParameterCollection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Transaction

Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand.

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: