DbBatch Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
-
DbBatch
- Implementazioni
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 |
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. |
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per