DbBatch Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbBatch.cs

Representa un lote de comandos que se pueden ejecutar en un origen de datos en un solo recorrido de ida y vuelta. Proporciona una clase base para clases específicas de la base de datos que representan lotes de comandos.

public ref class DbBatch abstract : IAsyncDisposable, IDisposable

public abstract class DbBatch : IAsyncDisposable, IDisposable

type DbBatch = class
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable

Herencia

Object

DbBatch

Implementaciones

IAsyncDisposable IDisposable

Comentarios

La semántica precisa de la ejecución por lotes varía en ADO.NET proveedores, especialmente en torno al control de errores. Cuando sea posible, se recomienda que un error en un comando dentro del lote finalice inmediatamente el lote, omita todos los comandos posteriores y revierte los comandos que ya se han ejecutado. Sin embargo, es posible que este comportamiento no se admita en las bases de datos; consulte la documentación del proveedor de ADO.NET.

Constructores

DbBatch()

Inicializa una nueva instancia de la clase DbBatch.

Propiedades

BatchCommands	Obtiene la colección de objetos DbBatchCommand.
Connection	Obtiene o establece el DbConnection usado por este DbBatch.
DbBatchCommands	Cuando se reemplaza en una clase derivada, obtiene la colección de objetos DbBatchCommand.
DbConnection	Cuando se reemplaza en una clase derivada, obtiene o establece el DbConnection usado por este DbBatch.
DbTransaction	Cuando se invalida en una clase derivada, obtiene o establece el DbTransaction dentro del cual se ejecuta este objeto DbBatch.
Timeout	Obtiene o establece el tiempo de espera (en segundos) antes de finalizar el intento de ejecutar el lote y generar un error.
Transaction	Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbBatch.

Métodos

Cancel()	Intenta cancelar la ejecución de un DbBatch.
CreateBatchCommand()	Crea una nueva instancia de un objeto DbBatchCommand.
CreateDbBatchCommand()	Cuando se reemplaza en una clase derivada, crea una nueva instancia de un objeto DbBatchCommand.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados.
DisposeAsync()	De forma asincrónica se dipa el objeto por lotes.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Cuando se invalida en una clase derivada, ejecuta el lote 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 lote en su objeto de conexión y devuelve el número total de filas afectadas en todos los comandos por lotes.
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(CommandBehavior)	Ejecuta el lote en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.
ExecuteReaderAsync(CancellationToken)	Una versión asincrónica de ExecuteReader, que ejecuta el lote en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Una versión asincrónica de ExecuteReader, que ejecuta el lote en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados.
ExecuteScalar()	Ejecuta el lote 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)	Una versión asincrónica de ExecuteScalar(), que ejecuta el lote 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.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Prepare()	Crea una versión preparada (o compilada) del lote, o de cada uno de sus comandos, en el origen de datos.
PrepareAsync(CancellationToken)	Crea de forma asincrónica una versión preparada (o compilada) del lote, o de cada uno de sus comandos, en el origen de datos.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

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.