Environment.FailFast メソッド

.NET Framework クラス ライブラリ リファレンス

Environment.FailFast メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

アクティブな try-finally ブロックまたはファイナライザを実行せずに、プロセスを終了します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub FailFast
 ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Environment.FailFast(message)

C#

public static void FailFast
 (
    string message
)

C++

public:
static void FailFast (
    String^ message
)

J#

public static void FailFast
 (
    String message
)

JScript

public static function FailFast
 (
    message : String
)

パラメータ

message

プロセスが終了された原因を説明するメッセージ。説明を提供しない場合は null 参照 (Visual Basic では Nothing)。

解説

FailFast メソッドは、message パラメータを使用して、ログ エントリを Windows アプリケーションのイベント ログに書き込み、アプリケーションのダンプを作成してから、現在のプロセスを終了させます。

アプリケーションの状態が回復できないほど悪化し、try-finally ブロックやファイナライザでは、プログラム リソースまでダメージを受けてしまうような場合は、Exit メソッドではなく、FailFast メソッドを使用してアプリケーションを終了してください。FailFast メソッドは、現在のプロセスを終了し、すべての CriticalFinalizerObject オブジェクトを実行します。ただし、アクティブな try-finally ブロックまたはファイナライザは一切実行されません。

使用例

ログ エントリを Windows アプリケーションのイベント ログに書き込み、現在のプロセスを終了させるコード例を次に示します。

Visual Basic

' This code example demonstrates the Environment.FailFast() 
' method.

Imports System

Class Sample
    Public Shared Sub Main()
 
        Dim causeOfFailure As String
 = "A castrophic failure has occured."
        
        ' Assume your application has failed catastrophically and must
 
        ' terminate immediately. The try-finally block is not executed
 
        ' and is included only to demonstrate that instructions within
 
        ' try-catch blocks and finalizers are not performed.

        Try
            Environment.FailFast(causeOfFailure)
        Finally
            Console.WriteLine("This finally block will not be
 executed.")
        End Try
    
    End Sub 'Main
End Class 'Sample

'
'This code example produces the following results:
'
'(No output is produced because the application is terminated. However,
 
'an entry is made in the Windows Application event log, and the log
 
'entry contains the text from the causeOfFailure variable.)
'

C#

// This code example demonstrates the Environment.FailFast() 
// method.

using System;

class Sample 
{
    public static void Main()
 
    {
    string causeOfFailure = "A castrophic failure has occured.";

// Assume your application has failed catastrophically and must 
// terminate immediately. The try-finally block is not executed 
// and is included only to demonstrate that instructions within 
// try-catch blocks and finalizers are not performed.

    try 
        {
        Environment.FailFast(causeOfFailure);
        }
    finally
        {
        Console.WriteLine("This finally block will not be
 executed.");
        }
    }
}

/*
This code example produces the following results:

(No output is produced because the application is terminated. However, 
an entry is made in the Windows Application event log, and the
 log 
entry contains the text from the causeOfFailure variable.)

*/

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。要求値 : LinkDemand; アクセス許可値 : UnmanagedCode

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Environment クラス
Environment メンバ
System 名前空間