DbConnection.ChangeDatabaseAsync(String, CancellationToken) Método

Definición

Cambia de forma asincrónica la base de datos actual de una conexión abierta.Asynchronously changes the current database for an open connection.

public virtual System.Threading.Tasks.Task ChangeDatabaseAsync (string databaseName, System.Threading.CancellationToken cancellationToken = default);
abstract member ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

databaseName
String

Nombre de la base de datos que va a utilizar la conexión.The name of the database for the connection to use.

cancellationToken
CancellationToken

Token opcional para cancelar la operación asincrónica.An optional token to cancel the asynchronous operation. El valor predeterminado es None.The default value is None.

Devoluciones

Task

Tarea que representa la operación asincrónica.A task representing the asynchronous operation.

Comentarios

El valor proporcionado en el databaseName parámetro debe ser un nombre de base de datos válido para la instancia actual.The value supplied in the databaseName parameter must be a valid database name for the current instance.

La implementación predeterminada de este método asincrónico delega en su homólogo sincrónico y devuelve un completado Task , lo que podría bloquear el subproceso de llamada.The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Los proveedores de datos que admiten la programación asincrónica deben invalidar la implementación predeterminada mediante operaciones de e/s asincrónicas.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Se aplica a