Trace.Fail メソッド (String, String)

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

<Conditional("TRACE")>
Overloads Public Shared Sub Fail( _   ByVal message As String, _   ByVal detailMessage As String _)
[C#]
[Conditional("TRACE")]
public static void Fail(stringmessage,stringdetailMessage);
[C++]
[Conditional("TRACE")]
public: static void Fail(String* message,String* detailMessage);
[JScript]
public
   Conditional("TRACE")
static function Fail(message : String,detailMessage : String);

パラメータ

• message
  出力するメッセージ。
• detailMessage
  出力する詳細メッセージ。

解説

既定のトレース リスナの既定の動作では、 message パラメータおよび detailedMessage パラメータがメッセージ ボックス (アプリケーションをユーザー インターフェイス モードで実行しているとき) と Listeners コレクションの TraceListener インスタンスに出力します。 Listeners コレクションに TraceListener を追加したり、コレクションから削除したりすることにより、既定の動作をカスタマイズできます。

使用例

Fail メソッドを使用して例外処理時にメッセージを出力する例を次に示します。

 
Catch
    Trace.Fail("Invalid value: " & value.ToString(), _
        "Resetting value to newValue.")
    value = newValue
End Try

[C#] 
catch (Exception) {
    Trace.Fail("Invalid value: " + value.ToString(), 
       "Resetting value to newValue.");
    value = newValue;
}

[C++] 
catch (Exception*) {
    Trace::Fail(String::Format( S"Invalid value: {0}", __box(value)), 
       S"Resetting value to newValue.");
    value = newValue;
}

[JScript] 
}catch(e : Exception){
    Trace.Fail("Invalid value: " + value.ToString(), "Resetting value to newValue.")
    value = newValue
}

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

 
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

[C#] 
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;
}

[C++] 
switch (option) {
    case Option::First:
       result = 1.0;
       break;
 
    // Insert additional cases.
 
    default:
       Trace::Fail(String::Format( S"Unsupported option {0}", __box(option)), S"Result set to 1.0");
       result = 1.0;
       break;
}

[JScript] 
switch(option){
  case 1:
    result = 1.0
    break
  // Insert additional cases.
  default:
    Trace.Fail("Unknown option: " + option, "result set to 1.0")
    result = 1.0
}

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Trace クラス | Trace メンバ | System.Diagnostics 名前空間 | Trace.Fail オーバーロードの一覧 | Debug | Trace | BooleanSwitch | TraceSwitch | TraceListener | DefaultTraceListener | ConditionalAttribute