Debug.Fail メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

netstandard.dll, System.Runtime.dll

エラー メッセージを出力します。

オーバーロード

名前	説明
Fail(String, String)	エラー メッセージと詳細なエラー メッセージを出力します。
Fail(String)	指定したエラー メッセージを出力します。

Fail(String, String)

ソース:

Debug.cs

エラー メッセージと詳細なエラー メッセージを出力します。

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail(string? message, string? detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string * string -> unit

Public Shared Sub Fail (message As String, detailMessage As String)

パラメーター

message

String

出力するメッセージ。

detailMessage

String

出力する詳細なメッセージ。

属性

ConditionalAttribute

例

次の例では、 Fail メソッドを使用して、例外処理中にメッセージを出力します。

catch (Exception)
{
    Debug.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch e As Exception
    Debug.Fail("Invalid value: " + value.ToString(), "Resetting value to newValue.")
    value = newValue
End Try

switch ステートメントで Fail メソッドを使用することもできます。

switch (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

注釈

既定の動作では、DefaultTraceListenerは、アプリケーションがユーザー インターフェイス モードで実行されているときにメッセージ ボックスにメッセージを出力し、Listeners コレクション内のTraceListener インスタンスに出力します。

注

メッセージ ボックスの表示は、 DefaultTraceListenerの有無によって異なります。 DefaultTraceListenerがListeners コレクションにない場合、メッセージ ボックスは表示されません。 DefaultTraceListenerは、<clear>、<remove>、または Listeners プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドを呼び出すことによって削除できます。

この動作をカスタマイズするには、 TraceListener を Listeners コレクションに追加するか、コレクションから削除します。

こちらもご覧ください

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Fail(String)

ソース:

Debug.cs

指定したエラー メッセージを出力します。

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail(string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string -> unit

Public Shared Sub Fail (message As String)

パラメーター

message

String

出力するメッセージ。

属性

ConditionalAttribute

例

次の例では、 Fail メソッドを使用して、例外処理中にメッセージを出力します。

catch (Exception)
{
    Debug.Fail("Unknown Option " + option + ", using the default.");
}

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", using the default.")
End Try

switch ステートメントで Fail メソッドを使用することもできます。

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

注釈

既定の動作では、DefaultTraceListenerは、アプリケーションがユーザー インターフェイス モードで実行されているときにメッセージ ボックスにメッセージを出力し、Listeners コレクション内のTraceListener インスタンスに出力します。

注

メッセージ ボックスの表示は、 DefaultTraceListenerの有無によって異なります。 DefaultTraceListenerがListeners コレクションにない場合、メッセージ ボックスは表示されません。 DefaultTraceListenerは、<clear>、<remove>、または Listeners プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドを呼び出すことによって削除できます。

この動作をカスタマイズするには、 TraceListener を Listeners コレクションに追加するか、コレクションから削除します。

こちらもご覧ください

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute