Trace.Fail メソッド (String)

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

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

パラメータ

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

解説

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

使用例

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

 
Catch
    Trace.Fail("Cannot find SpecialController, proceeding with StandardController")
End Try

[C#] 
catch (Exception) {
    Trace.Fail("Cannot find SpecialController, proceeding with StandardController");
}

[C++] 
catch (Exception*) {
    Trace::Fail(S"Cannot find SpecialController, proceeding with StandardController");
}

[JScript] 
try{
    // try something here
}catch(e : Exception){
    Trace.Fail("Operation failed.")
}

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

 
Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail(("Unknown Option " & option1))
        result = 1.0
End Select

[C#] 
switch (option) {
    case Option.First:
       result = 1.0;
       break;
 
    // Insert additional cases.
    default:
       Trace.Fail("Unknown Option " + option);
       result = 1.0;
       break;
}

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

[JScript] 
switch(value){
  case 1:
    result = 2.0
    break
  case 2:
    result = 4.0
    break

  // Insert additional cases.

  default:
    Trace.Fail("Unexpected value: " + value)
    result = 0.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 | ConditionalAttribute | ConditionalAttribute | ConditionalAttribute