DbBatch Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbBatch.cs

Rappresenta un batch di comandi che possono essere eseguiti su un'origine dati in un singolo round trip. Fornisce una classe di 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 diversi provider di ADO.NET, in particolare per la gestione degli errori. Quando possibile, è consigliabile che un errore in un comando all'interno del batch termina immediatamente il batch, ignora tutti i comandi successivi e esegue 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 la raccolta di oggetti DbBatchCommand.
Connection	Ottiene o imposta l'oggetto DbConnection utilizzato da DbBatch.
DbBatchCommands	In caso di override in una classe derivata, ottiene la raccolta di oggetti DbBatchCommand.
DbConnection	In caso di override in una classe derivata, ottiene o imposta la DbConnection usata da questo DbBatch.
DbTransaction	In caso di override in una classe derivata, ottiene o imposta la DbTransaction all'interno della quale viene eseguito questo oggetto DbBatch.
Timeout	Ottiene o imposta il tempo di attesa (in secondi) prima di terminare il tentativo di eseguire il batch e generare un errore.
Transaction	Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbBatch.

Metodi

Cancel()	Tenta di annullare l'esecuzione di un DbBatchoggetto .
CreateBatchCommand()	Crea una nuova istanza di un oggetto DbBatchCommand.
CreateDbBatchCommand()	In caso di override in una classe derivata, crea una nuova istanza di un oggetto DbBatchCommand.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
DisposeAsync()	Restituisce 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 oggetto 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 di ExecuteReader . L'implementazione predefinita richiama il metodo sincrono ExecuteReader() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno passate mediante la proprietà Task Exception restituita. Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo. Le implementazioni possono ignorare la richiesta.
ExecuteNonQuery()	Esegue il batch sul relativo oggetto di 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. Il token di annullamento può facoltativamente essere ignorato. L'implementazione predefinita richiama il metodo sincrono ExecuteNonQuery() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno passate mediante la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.
ExecuteReader(CommandBehavior)	Esegue il batch sulla connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati.
ExecuteReaderAsync(CancellationToken)	Versione asincrona di ExecuteReader, che esegue il batch sulla relativa connessione, restituendo un DbDataReader oggetto 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 oggetto 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. Vengono ignorate tutte le altre colonne, righe e set di risultati.
ExecuteScalarAsync(CancellationToken)	Versione asincrona di ExecuteScalar(), che esegue il batch e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Vengono ignorate tutte le altre colonne, righe e set di risultati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (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)

Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.