Trace.Fail メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
エラー メッセージを出力します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Fail(String) |
指定したエラー メッセージを出力します。 |
| Fail(String, String) |
エラー メッセージと詳細なエラー メッセージを出力します。 |
Fail(String)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
指定したエラー メッセージを出力します。
public:
static void Fail(System::String ^ message);[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string? message);[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string message);[<System.Diagnostics.Conditional("TRACE")>]
static member Fail : string -> unitPublic Shared Sub Fail (message As String)パラメーター
- message
- String
出力するメッセージ。
- 属性
例
次の例では、 Fail メソッドを使用して、例外処理中にメッセージを出力します。
catch (Exception)
{
Trace.Fail("Unknown Option " + option + ", using the default.");
}
Catch
Trace.Fail("Unknown Option " + option1 + ", using the default.")
End Try
switch ステートメントで Fail メソッドを使用することもできます。
switch (option)
{
case Option.First:
result = 1.0;
break;
// Insert additional cases.
default:
Trace.Fail("Unknown Option " + option);
result = 1.0;
break;
}
Select Case option1
Case OptionConsts.First
result = 1.0
' Insert additional cases.
Case Else
Trace.Fail(("Unknown Option " & option1))
result = 1.0
End Select
注釈
既定のトレース リスナーの既定の動作は、アプリケーションがユーザー インターフェイス モードで実行されるときにメッセージ ボックスに、およびListeners コレクション内のTraceListener インスタンスにmessage パラメーターを出力することです。
注
メッセージ ボックスの表示は、 DefaultTraceListenerの有無によって異なります。
DefaultTraceListenerがListeners コレクションにない場合、メッセージ ボックスは表示されません。
DefaultTraceListenerは、<clear>、<remove>、または Listeners プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドを呼び出すことによって削除できます。
この動作をカスタマイズするには、 TraceListener を Listeners コレクションに追加するか、 コレクションから削除します。
こちらもご覧ください
適用対象
Fail(String, String)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
エラー メッセージと詳細なエラー メッセージを出力します。
public:
static void Fail(System::String ^ message, System::String ^ detailMessage);[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string? message, string? detailMessage);[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string message, string detailMessage);[<System.Diagnostics.Conditional("TRACE")>]
static member Fail : string * string -> unitPublic Shared Sub Fail (message As String, detailMessage As String)パラメーター
- message
- String
出力するメッセージ。
- detailMessage
- String
出力する詳細なメッセージ。
- 属性
例
次の例では、 Fail メソッドを使用して、例外処理中にメッセージを出力します。
catch (Exception)
{
Trace.Fail("Invalid value: " + value.ToString(),
"Resetting value to newValue.");
value = newValue;
}
Catch
Trace.Fail("Invalid value: " & value.ToString(), _
"Resetting value to newValue.")
value = newValue
End Try
switch ステートメントで Fail メソッドを使用することもできます。
switch (option)
{
case Option.First:
result = 1.0;
break;
// Insert additional cases.
default:
Trace.Fail("Unsupported option " + option, "Result set to 1.0");
result = 1.0;
break;
}
Select Case option1
Case OptionConsts.First
result = 1.0
' Insert additional cases.
Case Else
Trace.Fail("Unsupported option " & option1, "Result set to 1.0")
result = 1.0
End Select
注釈
既定の動作では、アプリケーションがユーザー インターフェイス モードで実行されるときに、message パラメーターとdetailedMessage パラメーターがメッセージ ボックスに出力され、Listeners コレクション内のTraceListener インスタンスに出力されます。
注
メッセージ ボックスの表示は、 DefaultTraceListenerの有無によって異なります。
DefaultTraceListenerがListeners コレクションにない場合、メッセージ ボックスは表示されません。
DefaultTraceListenerは、<clear>、<remove>、または Listeners プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドを呼び出すことによって削除できます。
この動作をカスタマイズするには、 TraceListener を Listeners コレクションに追加するか、 コレクションから削除します。
