DbDataReader.DisposeAsync Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataReader.cs

Rilascia in modo asincrono le risorse usate dall'istanza corrente della classe DbDataReader.

public:
 virtual System::Threading::Tasks::ValueTask DisposeAsync();

public virtual System.Threading.Tasks.ValueTask DisposeAsync ();

abstract member DisposeAsync : unit -> System.Threading.Tasks.ValueTask
override this.DisposeAsync : unit -> System.Threading.Tasks.ValueTask

Public Overridable Function DisposeAsync () As ValueTask

Restituisce

ValueTask

ValueTask che rappresenta l'operazione asincrona.

Implementazioni

DisposeAsync()

Commenti

Chiamare Dispose o DisposeAsync al termine dell'uso di DbDataReader. La chiamata a uno di questi metodi lascia l'oggetto DbDataReader in uno stato inutilizzabile. Dopo aver sponito, è necessario rilasciare tutti i riferimenti all'oggetto DbDataReader in modo che Garbage Collector possa recuperare la memoria che l'oggetto DbDataReader occupava.

Per altre informazioni, vedere Pulizia delle risorse non gestite e implementazione di un metodo Dispose.

Nota

Eliminare sempre prima di rilasciare l'ultimo DbDataReaderriferimento a . In caso contrario, le risorse utilizzate non verranno liberate finché il metodo DbDataReader dell'oggetto Finalize non viene richiamato dal Garbage Collector.

L'implementazione predefinita di questo metodo asincrono delega la controparte sincrona e restituisce un oggetto completato ValueTask, potenzialmente bloccando il thread chiamante.

I provider di dati che supportano la programmazione asincrona devono eseguire l'override dell'implementazione predefinita usando operazioni di I/O asincrone.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Dispose().