Debug.Fail Método

Definição

Espaço de Nomes:: System.Diagnostics

Assemblagens:: System.dll, System.Diagnostics.Debug.dll

Assemblagem:: System.dll

Assemblagem:: System.Diagnostics.Debug.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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)

Emite a mensagem de erro especificada.

public:
 static void Fail(System::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)

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)
{
    Debug.Fail("Unknown Option " + option + ", using the default.");
}

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", 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:
        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

Observações

O comportamento padrão é que a DefaultTraceListener mensagem é enviada 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 TraceListener ou removendo um da Listeners coleção.

Ver também

Aplica-se a

Fail(String, String)

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

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

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