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

Task

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

Hinweise

Die Standard Implementierung dieser asynchronen Methode delegiert an die synchrone Entsprechung und gibt einen abgeschlossenen zurück Task , der den aufrufenden Thread potenziell 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 Standard Implementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Die Close -Methode und die- CloseAsync Methode setzen alle ausstehenden Transaktionen zurück.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 mehr als einmal aufzurufen.An application can call Close or CloseAsync more than one time. Es wird keine Ausnahme generiert.No exception is generated.

Wenn das den Gültigkeits DbConnection Bereich 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 aufrufen Dispose , 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 oder festgelegt ist true , wird yes 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 DbConnection DbDataReader in der-Methode der-Klasse weder ein-Objekt noch ein-Objekt oder ein anderes verwaltetes Objekt Finalize .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: