CriticalFinalizerObject CriticalFinalizerObject CriticalFinalizerObject CriticalFinalizerObject Class

定義

派生クラスのすべての終了コードが確実に重大であるとマークされるようにします。Ensures that all finalization code in derived classes is marked as critical.

public ref class CriticalFinalizerObject abstract
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class CriticalFinalizerObject
type CriticalFinalizerObject = class
Public MustInherit Class CriticalFinalizerObject
継承
CriticalFinalizerObjectCriticalFinalizerObjectCriticalFinalizerObjectCriticalFinalizerObject
派生
属性

次のコード例は、 SafeFileHandleクラスを使用して、標準の入力ストリームと出力ストリームに対して重大な終了処理を提供する方法を示しています。The following code example shows the use of the SafeFileHandle class to provide critical finalization for the standard input and output streams. クラスから派生したSafeFileHandleは、 FileStreamコンストラクター内のファイルストリームに渡されます。 SafeHandleThe SafeFileHandle, derived from the SafeHandle class, is passed to the file stream in the FileStream constructor.

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

注釈

CriticalFinalizerObjectクラスから派生するクラスは、制約された実行領域 (CER) として暗黙的に処理されます。Classes deriving from the CriticalFinalizerObject class are implicitly treated as a constrained execution region (CER). これには、厳密な信頼性コントラクトでコードを呼び出すために、ファイナライザーのコードが必要です。This requires code in the finalizer to only call code with a strong reliability contract. Cer の詳細については、 System.Runtime.ConstrainedExecution 「名前空間」を参照してください。For more information about CERs, see the System.Runtime.ConstrainedExecution namespace.

CriticalFinalizerObjectクラスから派生したクラスでは、共通言語ランタイム (clr) によって、ファイナライザーが CER の規則に従う場合は、clr によって実行される可能性があります。強制的にアプリケーションドメインをアンロードするか、スレッドを中止します。In classes derived from the CriticalFinalizerObject class, the common language runtime (CLR) guarantees that all critical finalization code will be given the opportunity to execute, provided the finalizer follows the rules for a CER, even in situations where the CLR forcibly unloads an application domain or aborts a thread. ファイナライザーが CER の規則に違反している場合は、正常に実行されない可能性があります。If a finalizer violates the rules for a CER, it might not successfully execute. さらに、CLR は、通常のファイナライザーと重大なファイナライザーの間に弱い順序を確立します。ガベージコレクションによって同時に解放されたオブジェクトの場合は、すべての重要でないファイナライザーがすべてのクリティカルファイナライザーの前に呼び出されます。In addition, the CLR establishes a weak ordering among normal and critical finalizers: for objects reclaimed by garbage collection at the same time, all the noncritical finalizers are called before any of the critical finalizers. たとえば、からFileStream SafeHandle 派生したクラスのデータを保持するなどのクラスでは、標準のファイナライザーを実行して、既存のバッファーデータをCriticalFinalizerObjectフラッシュできます。For example, a class such as FileStream, which holds data in the SafeHandle class that is derived from CriticalFinalizerObject, can run a standard finalizer to flush out existing buffered data.

ほとんどの場合、 CriticalFinalizerObjectクラスから派生するクラスを記述する必要はありません。In most cases, you do not need to write classes that derive from the CriticalFinalizerObject class. .NET Framework クラスライブラリには、 SafeHandleととCriticalHandleいう2つのクラスが用意されています。これは、リソースを処理するための重要な終了機能を提供しますThe .NET Framework class library provides two classes, SafeHandle and CriticalHandle, that provide critical finalization functionality for handle resources. さらに、.NET Framework には、 SafeHandleクラスから派生した一連の記述済みクラスが用意されており、このセットはMicrosoft.Win32.SafeHandles名前空間にあります。Furthermore, the .NET Framework provides a set of prewritten classes derived from the SafeHandle class, and this set is located in the Microsoft.Win32.SafeHandles namespace. これらのクラスは、ファイルおよびオペレーティングシステムハンドルをサポートするための一般的な機能を提供するように設計されています。These classes are designed to provide common functionality for supporting file and operating system handles.

コンストラクター

CriticalFinalizerObject() CriticalFinalizerObject() CriticalFinalizerObject() CriticalFinalizerObject()

CriticalFinalizerObject クラスの新しいインスタンスを初期化します。Initializes a new instance of the CriticalFinalizerObject class.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

CriticalFinalizerObject クラスによって使用されているすべてのリソースを解放します。Releases all the resources used by the CriticalFinalizerObject class.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

セキュリティ

SecurityPermission
アンマネージコードを呼び出すためのアクセス許可。for permission to call unmanaged code. セキュリティアクション: LinkDemandSecurity action: LinkDemand. 関連付けられた列挙型:UnmanagedCodeAssociated enumeration: UnmanagedCode

InheritanceDemand
継承者に対する完全な信頼の場合。for full trust for inheritors. このクラスは、部分的に信頼されているコードから使用することはできません。This class cannot be used by partially trusted code.

適用対象

こちらもご覧ください