Trace.Fail Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.TraceSource.dll

Выдает сообщение об ошибке.

Перегрузки

Fail(String)	Выдает указанное сообщение об ошибке.
Fail(String, String)	Выдает сообщение об ошибке и подробное сообщение об ошибке.

Fail(String)

Исходный код:

Trace.cs

Выдает указанное сообщение об ошибке.

public:
 static void Fail(System::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

Сообщение для отправки.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере метод 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

Вы также можете использовать метод Fail в инструкции switch.

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 в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).

Это поведение можно настроить, добавив в нее TraceListener или удалив ее из коллекции Listeners.

См. также раздел

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

Fail(String, String)

Исходный код:

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")>]
static member Fail : string * string -> unit

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

Параметры

message

String

Сообщение для отправки.

detailMessage

String

Подробное сообщение для отправки.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере метод 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

Вы также можете использовать метод Fail в инструкции switch.

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 в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).

Это поведение можно настроить, добавив в нее TraceListener или удалив ее из коллекции Listeners.

См. также раздел

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