Trace.Fail Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TraceSource.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)

Zdroj:

Trace.cs

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

Public Shared Sub Fail (message As String)

Parametry

message

String

Zpráva, která se má generovat.

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

V příkazu switch můžete také použít metodu Fail .

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ím chováním výchozího naslouchacího procesu trasování je výstup parametru message do pole se zprávou při spuštění aplikace v režimu uživatelského rozhraní a do TraceListener instancí v kolekci Listeners .

Poznámka

Zobrazení okna se zprávou závisí na přítomnosti objektu DefaultTraceListener. Pokud není DefaultTraceListener v kolekci Listeners , okno se zprávou se nezobrazí. Objekt DefaultTraceListener lze 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 TraceListener nebo ho odeberete Listeners .

Viz také

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

Fail(String, String)

Zdroj:

Trace.cs

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

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

Parametry

message

String

Zpráva, která se má generovat.

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

V příkazu switch můžete také použít metodu Fail .

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í trasování naslouchací proces výstupu message parametru a detailedMessage parametru do pole se zprávou, když aplikace běží v režimu uživatelského rozhraní, a do TraceListener instancí v kolekci Listeners .

Poznámka

Zobrazení okna se zprávou závisí na přítomnosti objektu DefaultTraceListener. Pokud není DefaultTraceListener v kolekci Listeners , okno se zprávou se nezobrazí. Objekt DefaultTraceListener lze 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 TraceListener nebo ho odeberete Listeners .

Viz také

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