DbConnection.CloseAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DbConnection.cs

Veritabanı bağlantısını zaman uyumsuz olarak kapatır.

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

Döndürülenler

Task

Task Zaman uyumsuz işlemi temsil eden bir.

Açıklamalar

Bu zaman uyumsuz yöntemin varsayılan uygulaması, zaman uyumlu muadilini temsil eder ve tamamlanmış Taskbir döndürür ve potansiyel olarak çağıran iş parçacığını engeller.

Zaman uyumsuz programlamayı destekleyen veri sağlayıcıları, zaman uyumsuz G/Ç işlemlerini kullanarak varsayılan uygulamayı geçersiz kılmalıdır.

Close ve CloseAsync yöntemleri bekleyen tüm işlemleri geri alır. Ardından bağlantı havuzu bağlantısını serbest bırakır veya bağlantı havuzu devre dışı bırakılırsa bağlantıyı kapatır.

Bir uygulama birden çok kez çağrı CloseCloseAsync yapabilir. Özel durum oluşturulmaz.

DbConnection kapsamı dışına çıkarsa kapatılmaz. Bu nedenle, işlevsel olarak eşdeğer olan veya Disposeçağırarak Close bağlantıyı açıkça kapatmanız gerekir. Bağlantı havuzu değeri Pooling veya yesolarak ayarlanırsatrue, fiziksel bağlantı da serbest bırakılır.

Dikkat

Sınıfınızın yönteminde Finalize bir DbConnection, veya başka bir DbDataReaderyönetilen nesneyi kapatmayın veya atmayın. Sonlandırıcıda yalnızca sınıfınızın doğrudan sahip olduğu yönetilmeyen kaynakları serbest bırakmanız gerekir. Sınıfınız yönetilmeyen kaynaklara sahip değilse, sınıf tanımınıza bir Finalize yöntem eklemeyin. Daha fazla bilgi için bkz . Çöp Toplama.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Close()özel durumlara bakın.