Trace.Fail Metoda

  • Reference

Definice

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

Vygeneruje chybovou zprávu.

Přetížení

Fail(String)

Vygeneruje zadanou chybovou zprávu.
Fail(String, String)

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

Fail(String)

Vygeneruje zadanou chybovou zprávu.

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)

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^ ) 
{
   #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

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(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

Poznámky

Výchozí chování výchozího naslouchacího procesu trasování je výstupem message parametru do pole se zprávou, když aplikace běží v režimu uživatelského rozhraní a instancím TraceListener v Listeners kolekci.

Poznámka

Zobrazení pole zprávy závisí na přítomnosti DefaultTraceListener. DefaultTraceListener Pokud není v Listeners kolekci, nezobrazí se okno se zprávou. Lze DefaultTraceListener ji odebrat vymazáním<>, <odebráním> 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 nebo TraceListener ji odeberete Listeners .

Viz také

Platí pro

Fail(String, String)

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

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)

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^ ) 
{
  #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

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(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

Poznámky

Výchozí chování je pro výchozí naslouchací proces message trasování výstupem parametru a detailedMessage parametru do pole zprávy při spuštění aplikace v režimu uživatelského rozhraní a TraceListener instancí v Listeners kolekci.

Poznámka

Zobrazení pole zprávy závisí na přítomnosti DefaultTraceListener. DefaultTraceListener Pokud není v Listeners kolekci, nezobrazí se okno se zprávou. Lze DefaultTraceListener ji odebrat vymazáním<>, <odebráním> 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 nebo TraceListener ji odeberete Listeners .

Viz také

Platí pro