DbConnection.CloseAsync Método

Definición

Cierra de forma asincrónica la conexión con la base de datos.Asynchronously closes the connection to the database.

public:
 virtual System::Threading::Tasks::Task ^ CloseAsync();
public virtual System.Threading.Tasks.Task CloseAsync ();
abstract member CloseAsync : unit -> System.Threading.Tasks.Task
override this.CloseAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function CloseAsync () As Task

Devoluciones

Task

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

Comentarios

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.

Los Close CloseAsync métodos y revierten las transacciones pendientes.The Close and CloseAsync methods roll back any pending transactions. Después liberan la conexión al grupo de conexiones o cierran la conexión si la agrupación de conexiones está deshabilitada.They then release the connection to the connection pool, or close the connection if connection pooling is disabled.

Una aplicación puede llamar a Close o CloseAsync más de una vez.An application can call Close or CloseAsync more than one time. No se genera ninguna excepción.No exception is generated.

Si DbConnection sale del ámbito, no se cierra.If the DbConnection goes out of scope, it is not closed. Por lo tanto, debe cerrar explícitamente la conexión mediante una llamada a Close o Dispose , que son funcionalmente equivalentes.Therefore, you must explicitly close the connection by calling Close or Dispose, which are functionally equivalent. Si el valor de la agrupación de conexiones Pooling se establece en true o yes , también libera la conexión física.If the connection pooling value Pooling is set to true or yes, this also releases the physical connection.

Precaución

No cierre ni elimine un DbConnection objeto, DbDataReader ni ningún otro objeto administrado en el Finalize método de la clase.Do not close or dispose a DbConnection, a DbDataReader, or any other managed object in the Finalize method of your class. En un finalizador, solo debe liberar los recursos no administrados que la clase posea directamente.In a finalizer, you should only release unmanaged resources that your class owns directly. Si la clase no dispone de recursos no administrados, no incluya un método Finalize en la definición de clase.If your class does not own any unmanaged resources, do not include a Finalize method in your class definition. Para obtener más información, consulte Recolección de elementos no utilizados.For more information, see Garbage Collection.

Se aplica a