CriticalFinalizerObject Sınıf

Tanım

public ref class CriticalFinalizerObject abstract

public abstract class CriticalFinalizerObject

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class CriticalFinalizerObject

type CriticalFinalizerObject = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type CriticalFinalizerObject = class

Public MustInherit Class CriticalFinalizerObject

Devralma

Object

CriticalFinalizerObject

Türetilmiş

System.IO.Enumeration.FileSystemEnumerator<TResult>

System.Runtime.InteropServices.CriticalHandle

System.Runtime.InteropServices.SafeHandle

System.Runtime.MemoryFailPoint

System.Threading.ReaderWriterLock

Diğer…

Öznitelikler

ComVisibleAttribute

Örnekler

Aşağıdaki kod örneği, standart giriş ve çıkış akışları için kritik sonlandırma sağlamak üzere sınıfının kullanımını SafeFileHandle gösterir. SafeFileHandlesınıfından SafeHandle türetilen , oluşturucudaki dosya akışına FileStream geçirilir.

using System;
using System.Runtime.InteropServices;
using System.IO;
using Microsoft.Win32.SafeHandles;

namespace CriticalFinalizer
{
    class Program
    {
        const int STD_INPUT_HANDLE   = -10;
        const int STD_OUTPUT_HANDLE = -11;
        const int STD_ERROR_HANDLE  =  -12;
        [DllImport("Kernel32.dll", CharSet = System.Runtime.InteropServices.CharSet.Auto)]
        public static extern IntPtr GetStdHandle(int type);

        static void Main(string[] args)
        {
            FileStream fsIn = null;
            FileStream fsOut = null;
            try
            {
                SafeFileHandle sfhIn = new SafeFileHandle(GetStdHandle(STD_INPUT_HANDLE), false);
                fsIn = new FileStream(sfhIn, FileAccess.Read);
                byte[] input = new byte[] {0};
                fsIn.Read(input,0,1);
                SafeFileHandle sfhOut = new SafeFileHandle(GetStdHandle(STD_OUTPUT_HANDLE), false);
                fsOut = new FileStream(sfhOut, FileAccess.Write);
                fsOut.Write(input,0,1);
                SafeFileHandle sf = fsOut.SafeFileHandle;
            }
            finally
            {
                if (fsIn != null)
                {
                    fsIn.Close();
                    fsIn = null;
                }
                if (fsOut != null)
                {
                    fsOut.Close();
                    fsOut = null;
                }
            }
        }
    }
}

Imports System.Runtime.InteropServices
Imports System.IO
Imports Microsoft.Win32.SafeHandles

Public Module Example
   Const STD_INPUT_HANDLE As Integer  = -10
   Const STD_OUTPUT_HANDLE As Integer = -11
   Const STD_ERROR_HANDLE As Integer  = -12

   Public Declare Auto Function GetStdHandle Lib "Kernel32" (type As Integer) As IntPtr

   Public Sub Main()
      Dim fsIn As FileStream = Nothing
      Dim fsOut As FileStream = Nothing

      Try
         Dim sfhIn As New SafeFileHandle(GetStdHandle(STD_INPUT_HANDLE), False)
         fsIn = new FileStream(sfhIn, FileAccess.Read)
         Dim input() As Byte = { 0 }
         fsIn.Read(input, 0, 1)
         Dim sfhOut As New SafeFileHandle(GetStdHandle(STD_OUTPUT_HANDLE), False)
         fsOut = New FileStream(sfhOut, FileAccess.Write)
         fsOut.Write(input, 0, 1)
         Dim sf As SafeFileHandle = fsOut.SafeFileHandle
      Finally
         If fsIn IsNot Nothing Then
            fsIn.Close()
            fsIn = Nothing
         End If
         If fsOut IsNot Nothing Then 
            fsOut.Close()
            fsOut = Nothing
         End If
      End Try
   End Sub
End Module

Açıklamalar

sınıfından CriticalFinalizerObject türetilen sınıflar örtük olarak kısıtlanmış yürütme bölgesi (CER) olarak kabul edilir. Bunun için sonlandırıcıdaki kodun yalnızca güçlü bir güvenilirlik sözleşmesine sahip kodu çağırması gerekir. CER'ler hakkında daha fazla bilgi için ad alanına System.Runtime.ConstrainedExecution bakın.

Sınıfından CriticalFinalizerObject türetilen sınıflarda ortak dil çalışma zamanı (CLR), CLR'nin bir uygulama etki alanını zorla kaldırdığı veya bir iş parçacığını durdurduğu durumlarda bile sonlandırıcının cer için kurallara uyması koşuluyla tüm kritik sonlandırma kodunun yürütülmesine olanak tanıyacağını garanti eder. Sonlandırıcı bir CER kurallarını ihlal ederse, başarıyla yürütülmeyebilir. Buna ek olarak, CLR normal ve kritik sonlandırıcılar arasında zayıf bir sıralama oluşturur: aynı anda çöp toplama tarafından geri alınan nesneler için kritik olmayan sonlandırıcıların tümü kritik sonlandırıcılardan önce çağrılır. Örneğin, öğesinden CriticalFinalizerObjecttüretilen sınıftaki verileri SafeHandle tutan gibi FileStreambir sınıf, mevcut arabelleğe alınan verileri temizlemek için standart bir sonlandırıcı çalıştırabilir.

Çoğu durumda, sınıfından CriticalFinalizerObject türetilen sınıfları yazmanız gerekmez. .NET Framework sınıf kitaplığı, SafeHandle kaynakları işlemek için kritik sonlandırma işlevselliği sağlayan iki sınıf ve CriticalHandlesağlar. Ayrıca, .NET Framework sınıfından türetilmiş SafeHandle bir dizi önceden yazılmış sınıf sağlar ve bu küme ad alanında Microsoft.Win32.SafeHandles bulunur. Bu sınıflar, dosya ve işletim sistemi tanıtıcılarını desteklemek için ortak işlevler sağlamak üzere tasarlanmıştır.

Oluşturucular

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• SafeHandle
• CriticalHandle
• Microsoft.Win32.SafeHandles
• Kısıtlı Yürütme Bölgeleri
• Güvenilirlik En İyi Yöntemleri