CriticalHandle.ReleaseHandle Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

CriticalHandle.cs

Türetilmiş bir sınıfta geçersiz kılındığında, tanıtıcıyı serbest bırakabilmek için gereken kodu yürütür.

protected:
 abstract bool ReleaseHandle();

protected abstract bool ReleaseHandle ();

abstract member ReleaseHandle : unit -> bool

Protected MustOverride Function ReleaseHandle () As Boolean

Döndürülenler

Boolean

true tanıtıcı başarıyla serbest bırakılırsa; aksi takdirde, yıkıcı bir hata durumunda , false. Bu durumda bir releaseHandleFailed Yönetilen Hata Ayıklama Yardımcısı oluşturur.

Açıklamalar

ReleaseHandle veya Dispose yöntemine tek bir çağrı yapıldığından emin olmak için uygun eşitleme mekanizmalarını kullanmanız koşuluyla yöntemin Close yalnızca bir kez çağrılacağı garanti edilir. ReleaseHandle veya IsClosed özelliği ise IsInvalid yöntemi çağrılmayacak.true Bu yöntemi türetilmiş sınıflarınızda CriticalHandle uygulayarak tanıtıcıyı boşaltmak için gereken tüm kodları yürütebilirsiniz. işlevinden CriticalHandle biri kaynak sızıntılarının önlenmesini garanti etmek olduğundan, uygulamanızdaki ReleaseHandle kod hiçbir zaman başarısız olmamalıdır. Aynı anda toplanan nesneler için normal sonlandırıcılar çalıştırıldıktan sonra çöp toplayıcı çağrıları ReleaseHandle ve çağırmak için kaynakları garanti eder ve devam ederken kesintiye uğramaz. Bu yöntem, örnek oluşturma zamanında (statik olarak belirlenebilir çağrı grafiğindeki tüm yöntemlerle birlikte) kısıtlanmış yürütme bölgesi (CER) olarak hazırlanacaktır. Bu, iş parçacığı durdurma kesmelerini engellese de, geçersiz kılınan ReleaseHandle yönteminizde hata yolları eklememeye dikkat etmeniz gerekir. Özellikle, özniteliğini ReliabilityContractAttribute içinden ReleaseHandleçağırdığınız tüm yöntemlere uygulayın. Çoğu durumda bu kod şu şekilde olmalıdır:

ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)

Ayrıca, basit temizleme için (örneğin, bir dosya tanıtıcısında Windows API'sini CloseHandle çağırmak) tek platform çağırma çağrısının dönüş değerini de de kontrol edebilirsiniz. Karmaşık temizleme için çok fazla program mantığınız ve bazıları başarısız olabilecek birçok yöntem çağrınız olabilir. Program mantığınızda bu servis taleplerinin her biri için geri dönüş kodu olduğundan emin olmanız gerekir.

ReleaseHandle Yöntem herhangi bir nedenle döndürürse falsereleaseHandleFailed Managed Debugging Assistant oluşturur.

Ayrıca bkz.

• Yönetilen Hata Ayıklama Yardımcılarıyla Çalışma Zamanı Hatalarını Tanılama
• ReleaseHandleFailed