DbBatch Clase

Definición

Espacio de nombres:
System.Data.Common
Ensamblado:
System.Data.Common.dll
Source:
DbBatch.cs
Source:
DbBatch.cs
Source:
DbBatch.cs
Source:
DbBatch.cs
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 los proveedores de ADO.NET, 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

Nombre Description
DbBatch()

Inicializa una nueva instancia de la clase DbBatch.

Propiedades

Nombre Description
BatchCommands

Obtiene la colección de DbBatchCommand objetos .
Connection

Obtiene o establece el DbConnection objeto utilizado por este DbBatchobjeto .
DbBatchCommands

Cuando se reemplaza en una clase derivada, obtiene la colección de DbBatchCommand objetos .
DbConnection

Cuando se invalida en una clase derivada, obtiene o establece el DbConnection utilizado por este DbBatch.
DbTransaction

Cuando se invalida en una clase derivada, obtiene o establece el objeto dentro del DbTransaction que se ejecuta este DbBatch objeto.
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 objeto en el DbTransaction que se ejecuta este DbBatch objeto.

Métodos

Nombre Description
Cancel()

Intenta cancelar la ejecución de .DbBatch
CreateBatchCommand()

Crea una nueva instancia de un DbBatchCommand objeto .
CreateDbBatchCommand()

Cuando se reemplaza en una clase derivada, crea una nueva instancia de un DbBatchCommand objeto .
Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados.
DisposeAsync()

Elimina de forma asincrónica 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 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 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 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(CommandBehavior)

Ejecuta el lote en su conexión y devuelve 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

Nombre Description
ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Se aplica a