DbBatch Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Origine:

DbBatch.cs

Rappresenta un batch di comandi che possono essere eseguiti su un'origine dati in un singolo round trip. Fornisce una classe base per classi specifiche del database che rappresentano batch di comandi.

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

Ereditarietà

Object

DbBatch

Implementazioni

IAsyncDisposable IDisposable

Commenti

La semantica precisa dell'esecuzione batch varia in base ai provider di ADO.NET, in particolare per la gestione degli errori. Quando possibile, è consigliabile che un errore in un comando all'interno del batch termini immediatamente il batch, ignorare tutti i comandi successivi ed eseguire il rollback dei comandi già eseguiti. Tuttavia, questo comportamento potrebbe non essere supportato tra i database; consultare la documentazione del provider di ADO.NET.

Costruttori

DbBatch()

Inizializza una nuova istanza della classe DbBatch.

Proprietà

BatchCommands	Ottiene l'insieme di oggetti DbBatchCommand.
Connection	Ottiene o imposta il DbConnection utilizzato da questo DbBatch.
DbBatchCommands	In caso di override in una classe derivata, ottiene la raccolta di oggetti DbBatchCommand.
DbConnection	Quando sottoposto a override in una classe derivata, ottiene o imposta il DbConnection utilizzato da questo DbBatch.
DbTransaction	Quando sottoposto a override in una classe derivata, ottiene o imposta il DbTransaction all'interno del quale viene eseguito l'oggetto DbBatch.
Timeout	Ottiene o imposta il tempo di attesa , espresso in secondi, prima di terminare il tentativo di eseguire il batch e generare un errore.
Transaction	Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbBatch.

Metodi

Cancel()	Tenta di annullare l'esecuzione di un DbBatch.
CreateBatchCommand()	Crea una nuova istanza di un oggetto DbBatchCommand.
CreateDbBatchCommand()	Quando sottoposto a override in una classe derivata, crea una nuova istanza di un oggetto DbBatchCommand.
Dispose()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.
DisposeAsync()	Depose in modo asincrono l'oggetto batch.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)	Quando sottoposto a override in una classe derivata, esegue il batch sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	I provider devono implementare questo metodo per fornire un'implementazione non predefinita per gli overload ExecuteReader. L'implementazione predefinita richiama il metodo ExecuteReader() sincrono e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno comunicate tramite la proprietà Task Exception restituita. Questo metodo accetta un token di annullamento che può essere usato per richiedere l'annullamento anticipato dell'operazione. Le implementazioni possono ignorare questa richiesta.
ExecuteNonQuery()	Esegue il batch sul relativo oggetto connessione, restituendo il numero totale di righe interessate in tutti i comandi batch.
ExecuteNonQueryAsync(CancellationToken)	Si tratta della versione asincrona di ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo ExecuteNonQuery() sincrono e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbCommand fino al completamento dell'attività restituita.
ExecuteReader(CommandBehavior)	Esegue il batch sulla connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteReaderAsync(CancellationToken)	Versione asincrona di ExecuteReader, che esegue il batch sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Versione asincrona di ExecuteReader, che esegue il batch sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteScalar()	Esegue il batch e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate.
ExecuteScalarAsync(CancellationToken)	Versione asincrona di ExecuteScalar(), che esegue il batch e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Prepare()	Crea una versione preparata (o compilata) del batch o di ognuno dei relativi comandi nell'origine dati.
PrepareAsync(CancellationToken)	Crea in modo asincrono una versione preparata (o compilata) del batch o di ognuno dei relativi comandi nell'origine dati.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.