Debug.Fail Метод

Определение

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

System.Diagnostics

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

Fail(String, String)

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

Debug.cs

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

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail(string? message, string? detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string * string -> unit

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

Параметры

message

String

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

detailMessage

String

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

Атрибуты

ConditionalAttribute

Примеры

В следующем примере метод используется Fail для печати сообщения во время обработки исключений.

catch (Exception)
{
    Debug.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch e As Exception
    Debug.Fail("Invalid value: " + value.ToString(), "Resetting value to newValue.")
    value = newValue
End Try

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

switch (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Комментарии

Поведение по умолчанию заключается в том, что DefaultTraceListener сообщение выводится в поле сообщения при запуске приложения в режиме пользовательского интерфейса и TraceListener в экземпляры коллекции Listeners .

Замечание

Отображение поля сообщения зависит от наличия DefaultTraceListener. Если объект DefaultTraceListener не находится в Listeners коллекции, окно сообщения не отображается. Его DefaultTraceListener можно удалить с помощью <очистки>, <удаления> или вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).

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

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

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

Fail(String)

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

Debug.cs

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

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail(string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string -> unit

Public Shared Sub Fail (message As String)

Параметры

message

String

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

Атрибуты

ConditionalAttribute

Примеры

В следующем примере метод используется Fail для печати сообщения во время обработки исключений.

catch (Exception)
{
    Debug.Fail("Unknown Option " + option + ", using the default.");
}

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", using the default.")
End Try

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

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

Комментарии

Поведение по умолчанию заключается в том, что DefaultTraceListener сообщение выводится в поле сообщения при запуске приложения в режиме пользовательского интерфейса и TraceListener в экземпляры коллекции Listeners .

Замечание

Отображение поля сообщения зависит от наличия DefaultTraceListener. Если объект DefaultTraceListener не находится в Listeners коллекции, окно сообщения не отображается. Его DefaultTraceListener можно удалить с помощью <очистки>, <удаления> или вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).

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

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

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