DbBatch Classe

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

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 provedores de ADO.NET, 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 pelo 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 este DbBatch.
DbTransaction	Quando substituído em uma classe derivada, obtém ou define o DbTransaction dentro do qual este 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 DbBatch em que este objeto DbTransaction é 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()	Realiza tarefas definidas pelo aplicativo associadas à 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 ExecuteReader. A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. 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)	Essa é a versão assíncrona de ExecuteNonQuery(). 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 ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbCommand até a Tarefa retornada ser concluída.
ExecuteReader(CommandBehavior)	Executa o lote em 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 Object atual. (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 são realizadas.