DbBatch Classe

Definição

Espaço de Nomes:
System.Data.Common
Assemblagem:
System.Data.Common.dll
Origem:
DbBatch.cs
Origem:
DbBatch.cs
Origem:
DbBatch.cs
Origem:
DbBatch.cs
Origem:
DbBatch.cs

Representa um conjunto de comandos que podem ser executados contra uma fonte de dados numa única viagem de ida e volta. Fornece uma classe base para classes específicas da base de dados que representam 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
Herança
Object
DbBatch
Implementações
IAsyncDisposable IDisposable

Observações

A semântica precisa da execução em lote varia entre fornecedores ADO.NET, especialmente no que diz respeito ao tratamento de erros. Quando possível, recomenda-se que um erro num comando dentro do lote termine imediatamente o lote, pule todos os comandos subsequentes e reverta comandos já executados. No entanto, este comportamento pode não ser suportado entre bases de dados; consulte a documentação do seu fornecedor ADO.NET.

Construtores

Name Description
DbBatch()

Inicializa uma nova instância da DbBatch classe.

Propriedades

Name Description
BatchCommands

Fica com a coleção de DbBatchCommand objetos.
Connection

Obtém ou define o DbConnection usado por este DbBatch.
DbBatchCommands

Quando sobrescrito numa classe derivada, obtém a coleção de DbBatchCommand objetos.
DbConnection

Quando sobrescrito numa classe derivada, obtém ou define o DbConnection usado por esta DbBatch.
DbTransaction

Quando sobrescrito numa classe derivada, obtém ou define o DbTransaction dentro do qual este DbBatch objeto executa.
Timeout

Obtém ou define o tempo de espera (em segundos) antes de terminar a tentativa de executar o lote e gerar um erro.
Transaction

Obtém ou define o DbTransaction dentro do qual este DbBatch objeto executa.

Métodos

Name Description
Cancel()

Tentativas de cancelar a execução de um DbBatch.
CreateBatchCommand()

Cria uma nova instância de um DbBatchCommand objeto.
CreateDbBatchCommand()

Quando sobrescrito numa classe derivada, cria-se uma nova instância de um DbBatchCommand objeto.
Dispose()

Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.
DisposeAsync()

O objeto batch elimina assíncrono.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteDbDataReader(CommandBehavior)

Quando sobrescrito numa classe derivada, executa o lote contra a sua ligação, retornando um DbDataReader que pode ser usado para aceder aos resultados.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Os fornecedores devem implementar este método para fornecer uma implementação não padrão para ExecuteReader sobrecargas.

A implementação padrão invoca o método síncrono ExecuteReader() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido.
ExecuteNonQuery()

Executa o batch contra o seu objeto de ligação, retornando o número total de linhas afetadas em todos os comandos batch.
ExecuteNonQueryAsync(CancellationToken)

Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.

A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.
ExecuteReader(CommandBehavior)

Executa o lote contra a sua ligação, retornando um DbDataReader que pode ser usado para aceder aos resultados.
ExecuteReaderAsync(CancellationToken)

Uma versão assíncrona de ExecuteReader, que executa o lote contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Uma versão assíncrona de ExecuteReader, que executa o lote contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.
ExecuteScalar()

Executa o lote e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
ExecuteScalarAsync(CancellationToken)

Uma versão assíncrona de ExecuteScalar(), que executa o lote e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Prepare()

Cria uma versão preparada (ou compilada) do lote, ou de cada um dos seus comandos, na fonte de dados.
PrepareAsync(CancellationToken)

De forma assíncrona, cria-se uma versão preparada (ou compilada) do lote, ou de cada um dos seus comandos, na fonte de dados.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Métodos da Extensão

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Configura como aguarda nas tarefas devolvidas de um descartável assíncrono será realizada.

Aplica-se a