Debug.Fail Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Порождает сообщение об ошибке.
| Fail(String, String) |
Выдает простое и подробное сообщение об ошибке. |
| Fail(String) |
Выдает указанное сообщение об ошибке. |
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- 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")]
public static void Fail (string? message, string? detailMessage);[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string * string -> unitPublic Shared Sub Fail (message As String, detailMessage As String)Параметры
- message
- String
Выдаваемое сообщение.
- detailMessage
- String
Выдаваемое подробное сообщение.
- Атрибуты
Примеры
В следующем примере метод используется Fail для печати сообщения во время обработки исключений.
catch ( Exception^ e )
{
#if defined(DEBUG)
Debug::Fail( "Cannot find SpecialController, proceeding with StandardController", "Setting Controller to default value" );
#endif
}
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 ( option )
{
case Option::First:
result = 1.0;
break;
// Insert additional cases.
default:
#if defined(DEBUG)
Debug::Fail( "Unknown Option" + option, "Result set to 1.0" );
#endif
result = 1.0;
break;
}
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>, <remove> или путем вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).
Это поведение можно настроить, добавив TraceListener в коллекцию или удалив его из Listeners коллекции.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Выдает указанное сообщение об ошибке.
public:
static void Fail(System::String ^ message);[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string message);[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string? message);[<System.Diagnostics.Conditional("DEBUG")>]
static member Fail : string -> unitPublic Shared Sub Fail (message As String)Параметры
- message
- String
Выдаваемое сообщение.
- Атрибуты
Примеры
В следующем примере метод используется Fail для печати сообщения во время обработки исключений.
catch ( Exception^ e )
{
#if defined(DEBUG)
Debug::Fail( "Unknown Option " + option + ", using the default." );
#endif
}
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:
#if defined(DEBUG)
Debug::Fail( "Unknown Option" + option );
#endif
result = 1.0;
break;
}
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>, <remove> или путем вызова Clear метода в свойстве Listeners (System.Diagnostics.Trace.Listeners.Clear()).
Это поведение можно настроить, добавив TraceListener в коллекцию или удалив его из Listeners коллекции.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
