DbBatch Classe

  • Referência

Definição

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Origem:
DbBatch.cs
Origem:
DbBatch.cs
Origem:
DbBatch.cs

Representa um lote de comandos que podem ser executados em uma fonte de dados em uma única viagem de ida e volta. Fornece uma classe base para classes específicas do banco de dados que representam lotes de comando.

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

Comentários

A semântica precisa da execução em lote varia entre ADO.NET provedores, especialmente em relação ao tratamento de erros. Quando possível, é recomendável que um erro em um comando dentro do lote encerre imediatamente o lote, ignore todos os comandos subsequentes e reverta os comandos que já foram executados. No entanto, esse comportamento pode não ter suporte em bancos de dados; consulte a documentação do provedor de ADO.NET.

Construtores

DbBatch()

Inicializa uma nova instância da classe DbBatch.

Propriedades

BatchCommands

Obtém a coleção de objetos DbBatchCommand.
Connection

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

Quando substituído em uma classe derivada, obtém a coleção de objetos DbBatchCommand.
DbConnection

Quando substituído em uma classe derivada, obtém ou define o DbConnection usado por esse DbBatch.
DbTransaction

Quando substituído em uma classe derivada, obtém ou define o DbTransaction no qual esse objeto DbBatch é executado.
Timeout

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

Obtém ou define o DbTransaction no qual esse objeto DbBatch é executado.

Métodos

Cancel()

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

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

Quando substituído em uma classe derivada, cria uma nova instância de um objeto DbBatchCommand.
Dispose()

Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.
DisposeAsync()

Mergulha de forma assíncrona o objeto do lote.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteDbDataReader(CommandBehavior)

Quando substituído em uma classe derivada, executa o lote em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas de ExecuteReader.

A implementação padrão invoca o método de ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteReader serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.

Esse método aceita um token de cancelamento que pode ser usado para solicitar que a operação seja cancelada antecipadamente. As implementações podem ignorar essa solicitação.
ExecuteNonQuery()

Executa o lote em relação ao objeto de conexão, retornando o número total de linhas afetadas em todos os comandos do lote.
ExecuteNonQueryAsync(CancellationToken)

Esta é a versão assíncrona do ExecuteNonQuery(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado.

A implementação padrão invoca o método de ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.

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

Executa o lote em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteReaderAsync(CancellationToken)

Uma versão assíncrona do ExecuteReader, que executa o lote em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Uma versão assíncrona do ExecuteReader, que executa o lote em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteScalar()

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

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

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Prepare()

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

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

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Métodos de Extensão

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono serão executadas.

Aplica-se a