Trace.Fail Método

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagens:
netstandard.dll, System.Diagnostics.TraceSource.dll
Assemblagem:
System.Diagnostics.TraceSource.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Emite uma mensagem de erro.

Sobrecargas

Name Description
Fail(String)

Emite a mensagem de erro especificada.
Fail(String, String)

Emite uma mensagem de erro e uma mensagem de erro detalhada.

Fail(String)

Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs

Emite a mensagem de erro especificada.

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)

Parâmetros

message
String

Uma mensagem para emitir.

Atributos
ConditionalAttribute

Exemplos

O exemplo seguinte utiliza o Fail método para imprimir uma mensagem durante o tratamento de exceções.

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

Catch
    Trace.Fail("Unknown Option " + option1 + ", using the default.")
End Try

Também pode usar o Fail método numa instrução switch.

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

Observações

O comportamento padrão do ouvinte de traços padrão é enviar o message parâmetro para uma caixa de mensagem quando a aplicação está a correr em modo de interface de utilizador, e para as TraceListener instâncias da Listeners coleção.

Note

A visualização da caixa de mensagens depende da presença do DefaultTraceListener. Se o DefaultTraceListener não estiver na Listeners coleção, a caixa de mensagem não é exibida. O DefaultTraceListener pode ser removido pelo <clear>, pelo <remove>, ou chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()).

Pode personalizar este comportamento adicionando um TraceListener ou removendo um da Listeners coleção.

Ver também

Aplica-se a

Fail(String, String)

Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.cs

Emite uma mensagem de erro e uma mensagem de erro detalhada.

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)

Parâmetros

message
String

Uma mensagem para emitir.

detailMessage
String

Uma mensagem detalhada para emitir.

Atributos
ConditionalAttribute

Exemplos

O exemplo seguinte utiliza o Fail método para imprimir uma mensagem durante o tratamento de exceções.

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

Também pode usar o Fail método numa instrução switch.

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

Observações

O comportamento predefinido é que o ouvinte de traços padrão envie o message parâmetro e o detailedMessage parâmetro para uma caixa de mensagem quando a aplicação está a correr em modo de interface de utilizador, e para as TraceListener instâncias da Listeners coleção.

Note

A visualização da caixa de mensagens depende da presença do DefaultTraceListener. Se o DefaultTraceListener não estiver na Listeners coleção, a caixa de mensagem não é exibida. O DefaultTraceListener pode ser removido pelo <clear>, pelo <remove>, ou chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()).

Pode personalizar este comportamento adicionando um TraceListener ou removendo um da Listeners coleção.

Ver também

Aplica-se a