DbConnection.CloseAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schließt die Verbindung mit der Datenbank asynchron.
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.TaskPublic Overridable Function CloseAsync () As TaskGibt zurück
A Task representing the asynchron operation.
Hinweise
Die Standardimplementierung dieser asynchronen Methode delegiert an das synchrone Gegenstück und gibt einen abgeschlossenen Task, möglicherweise blockierten Thread zurück.
Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen überschreiben.
Die Close Methoden führen CloseAsync ein Rollback für alle ausstehenden Transaktionen durch. Sie lassen dann die Verbindung mit dem Verbindungspool frei, oder schließen Sie die Verbindung, wenn die Verbindungspooling deaktiviert ist.
Eine Anwendung kann mehrere Aufrufe oder CloseAsync mehrere Mal ausführenClose. Es wird keine Ausnahme generiert.
Wenn der DbConnection Bereich nicht mehr vorhanden ist, wird er nicht geschlossen. Daher müssen Sie die Verbindung explizit schließen, indem Sie die Verbindung aufrufen Close oder Dispose, die funktionell gleichwertig sind. Wenn der Wert für den Verbindungspooling Pooling auf true die yesphysische Verbindung festgelegt oder freigegeben wird.
Vorsicht
Schließen Oder verwerfen Sie kein , ein DbConnectionDbDataReaderoder ein anderes verwaltetes Objekt in der Finalize Methode Ihrer Klasse. In einem Finalizer sollten Sie nur nicht verwaltete Ressourcen freigeben, die Ihre Klasse direkt besitzt. Wenn die Klasse keine nicht verwalteten Ressourcen besitzt, definieren Sie in der Klasse keine Finalize-Methode. Weitere Informationen finden Sie unter Garbage Collection.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Close().