DbDataSource.OpenConnectionAsync(CancellationToken) Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Origine:

DbDataSource.cs

Restituisce in modo asincrono una nuova connessione aperta al database rappresentato da questo DbDataSourceoggetto .

public System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenConnectionAsync (System.Threading.CancellationToken cancellationToken = default);

member this.OpenConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>

Public Function OpenConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)

Parametri

cancellationToken

CancellationToken

Token per annullare l'operazione asincrona.

Restituisce

ValueTask<DbConnection>

Nuova connessione aperta al database rappresentato da questo DbDataSourceoggetto .

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

La connessione restituita è già aperta ed è pronta per l'uso immediato.

È responsabilità del chiamante eliminare correttamente la connessione restituita da questo metodo. In caso contrario, potrebbe verificarsi una perdita di connessione.

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 OpenConnection().