Trace.Fail メソッド

定義

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

オーバーロード

Fail(String)

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

Fail(String, String)

エラー メッセージ、および詳細なエラー メッセージを出力します。

Fail(String)

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

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 -> unit
Public Shared Sub Fail (message As String)

パラメーター

message
String

出力するメッセージ。

属性

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

catch ( Exception^ ) 
{
   #if defined(TRACE)
   Trace::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}
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:
      #if defined(TRACE)
      Trace::Fail(String::Format("Unknown Option {0}", option));
      #endif
      result = 1.0;
      break;
}
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

注釈

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

注意

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

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

こちらもご覧ください

適用対象

Fail(String, String)

エラー メッセージ、および詳細なエラー メッセージを出力します。

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 -> unit
Public Shared Sub Fail (message As String, detailMessage As String)

パラメーター

message
String

出力するメッセージ。

detailMessage
String

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

属性

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

catch ( Exception^ ) 
{
  #if defined(TRACE)
  Trace::Fail( String::Format( "Invalid value: {0}", value ),
      "Resetting value to newValue." );
   #endif
   value = newValue;
}
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:
      #if defined(TRACE)
      Trace::Fail( String::Format( "Unsupported option {0}", option ),
         "Result set to 1.0" );
      #endif
      result = 1.0;
      break;
}
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 アプリケーションがユーザーインターフェイスモードで実行されるときにパラメーターとパラメーターをメッセージボックスに出力し、コレクション内のインスタンスに対してパラメーターを出力し TraceListener Listeners ます。

注意

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

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

こちらもご覧ください

適用対象