DbConnection.CloseAsync Methode

Definition

Schließt asynchron die Verbindung mit der DatenbankAsynchronously 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

Gibt zurück

Eine Task, die den asynchronen Vorgang darstellt.A Task representing the asynchronous operation.

Hinweise

Die Standard Implementierung dieser asynchronen Methode delegiert an die synchrone Entsprechung und gibt eine abgeschlossene Taskzurück, die möglicherweise den aufrufenden Thread blockiert.The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Die Methoden Close und CloseAsync führen ein Rollback für alle ausstehenden Transaktionen aus.The Close and CloseAsync methods roll back any pending transactions. Anschließend wird die Verbindung zum Verbindungspool freigegeben, oder die Verbindung wird geschlossen, wenn das Verbindungspooling deaktiviert ist.They then release the connection to the connection pool, or close the connection if connection pooling is disabled.

Eine Anwendung kann Close oder CloseAsync mehrmals aufzurufen.An application can call Close or CloseAsync more than one time. Es wird keine Ausnahme generiert.No exception is generated.

Wenn das DbConnection den Gültigkeitsbereich verlässt, wird es nicht geschlossen.If the DbConnection goes out of scope, it is not closed. Daher müssen Sie die Verbindung explizit schließen, indem Sie Close oder Disposeaufrufen, die funktionell äquivalent sind.Therefore, you must explicitly close the connection by calling Close or Dispose, which are functionally equivalent. Wenn der Wert für das Verbindungspooling Pooling auf true oder yesfestgelegt ist, wird auch die physische Verbindung freigegeben.If the connection pooling value Pooling is set to true or yes, this also releases the physical connection.

Achtung

Schließen oder löschen Sie keine DbConnection, eine DbDataReaderoder ein anderes verwaltetes Objekt in der Finalize-Methode der Klasse.Do not close or dispose a DbConnection, a DbDataReader, or any other managed object in the Finalize method of your class. In einem Finalizer sollten Sie nur nicht verwaltete Ressourcen freigeben, die Ihre Klasse direkt besitzt.In a finalizer, you should only release unmanaged resources that your class owns directly. Wenn die Klasse keine nicht verwalteten Ressourcen besitzt, definieren Sie in der Klasse keine Finalize-Methode.If your class does not own any unmanaged resources, do not include a Finalize method in your class definition. Weitere Informationen finden Sie unter Garbage Collection.For more information, see Garbage Collection.

Gilt für: