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 entre 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 subsiguientes y revierta 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 objeto DbConnection utilizado por este DbBatch.
DbBatchCommands	Cuando se invalida en una clase derivada, obtiene la colección de objetos DbBatchCommand.
DbConnection	Cuando se invalida en una clase derivada, obtiene o establece la instancia de DbConnection que usa este elemento DbBatch.
DbTransaction	Cuando se invalida en una clase derivada, obtiene o establece el elemento DbTransaction en el que 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 DbTransaction dentro del cual se ejecuta este objeto DbBatch.

Métodos

Cancel()	Intenta cancelar la ejecución de .DbBatch
CreateBatchCommand()	Crea una nueva instancia de un objeto DbBatchCommand.
CreateDbBatchCommand()	Cuando se invalida en una clase derivada, crea una instancia de un objeto DbBatchCommand.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
DisposeAsync()	Suprime de forma asincrónica el objeto batch.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Cuando se invalida en una clase derivada, ejecuta el lote 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 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 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(CommandBehavior)	Ejecuta el lote en su conexión y devuelve un DbDataReader objeto 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, que devuelve un DbDataReader objeto 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, que devuelve un DbDataReader objeto 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. Todas las demás columnas, filas y conjuntos de resultados se omiten.
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. Todas las demás columnas, filas y conjuntos de resultados se omiten.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (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 la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.