Debug.Fail Metoda

  • Reference

Definice

Obor názvů:
System.Diagnostics
Sestavení:
System.Diagnostics.Debug.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Vygeneruje chybovou zprávu.

Přetížení

Fail(String, String)

Vygeneruje chybovou zprávu a podrobnou chybovou zprávu.
Fail(String)

Vygeneruje zadanou chybovou zprávu.

Fail(String, String)

Zdroj:
Debug.cs
Zdroj:
Debug.cs
Zdroj:
Debug.cs

Vygeneruje chybovou zprávu a podrobnou chybovou zprávu.

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

Parametry

message
String

Zpráva, která se má vygenerovat.

detailMessage
String

Podrobná zpráva, která se má vygenerovat.

Atributy
ConditionalAttribute

Příklady

Následující příklad používá metodu Fail k tisku zprávy během zpracování výjimek.

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

Metodu Fail můžete použít také v příkazu 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

Poznámky

Výchozí chování je, že DefaultTraceListener se zpráva vypíše do pole se zprávou, když je aplikace spuštěna v režimu uživatelského rozhraní a do TraceListener instancí v kolekci Listeners .

Poznámka

Zobrazení pole se zprávou závisí na přítomnosti objektu DefaultTraceListener. Pokud objekt DefaultTraceListener není v kolekci Listeners , nezobrazí se okno se zprávou. Objekt DefaultTraceListener lze odebrat pomocí< příkazu clear>, <remove> nebo voláním Clear metody u Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()).

Toto chování můžete přizpůsobit tak, že do kolekce přidáte TraceListener nebo ho z kolekce odeberete Listeners .

Viz také

Platí pro

Fail(String)

Zdroj:
Debug.cs
Zdroj:
Debug.cs
Zdroj:
Debug.cs

Vygeneruje zadanou chybovou zprávu.

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

Parametry

message
String

Zpráva, která se má vygenerovat.

Atributy
ConditionalAttribute

Příklady

Následující příklad používá metodu Fail k tisku zprávy během zpracování výjimek.

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

Metodu Fail můžete použít také v příkazu 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

Poznámky

Výchozí chování je, že DefaultTraceListener se zpráva vypíše do pole se zprávou, když je aplikace spuštěna v režimu uživatelského rozhraní a do TraceListener instancí v kolekci Listeners .

Poznámka

Zobrazení pole se zprávou závisí na přítomnosti objektu DefaultTraceListener. Pokud objekt DefaultTraceListener není v kolekci Listeners , nezobrazí se okno se zprávou. Objekt DefaultTraceListener lze odebrat pomocí< příkazu clear>, <remove> nebo voláním Clear metody u Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()).

Toto chování můžete přizpůsobit tak, že do kolekce přidáte TraceListener nebo ho z kolekce odeberete Listeners .

Viz také

Platí pro