DbBatch Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
-
DbBatch
- Implementações
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 |
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. |
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de