Debug.Fail Debug.Fail Debug.Fail Debug.Fail Method

Definição

Emite uma mensagem de erro.Emits an error message.

Sobrecargas

Fail(String) Fail(String) Fail(String) Fail(String)

Emite a mensagem de erro especificada.Emits the specified error message.

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Emite uma mensagem de erro e uma mensagem de erro detalhada.Emits an error message and a detailed error message.

Fail(String) Fail(String) Fail(String) Fail(String)

Emite a mensagem de erro especificada.Emits the specified error message.

public:
 static void Fail(System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string message);
static member Fail : string -> unit
Public Shared Sub Fail (message As String)

Parâmetros

message
String String String String

Uma mensagem a ser emitida.A message to emit.

Exemplos

O exemplo a seguir usa Fail o método para imprimir uma mensagem durante a manipulação de exceção.The following example uses the Fail method to print a message during exception handling.

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

Você também pode usar o Fail método em uma instrução switch.You can also use the Fail method in a switch statement.

   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

Comentários

O comportamento padrão é que o DefaultTraceListener produz a mensagem em uma caixa de mensagem quando o aplicativo está sendo executado no modo de interface do TraceListener usuário e nas Listeners instâncias na coleção.The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.

Observação

A exibição da caixa de mensagem depende da presença do DefaultTraceListener.The display of the message box is dependent on the presence of the DefaultTraceListener. Se o DefaultTraceListener não estiver Listeners na coleção, a caixa de mensagem não será exibida.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. O DefaultTraceListener pode ser removido <por>CLEAR, Removeou>chamando o método na propriedade ( <). Clear Listeners System.Diagnostics.Trace.Listeners.Clear()The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Você pode personalizar esse comportamento adicionando um TraceListener ou removendo um da Listeners coleção.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Veja também

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Emite uma mensagem de erro e uma mensagem de erro detalhada.Emits an error message and a detailed error message.

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);
[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string message, string detailMessage);
static member Fail : string * string -> unit
Public Shared Sub Fail (message As String, detailMessage As String)

Parâmetros

message
String String String String

Uma mensagem a ser emitida.A message to emit.

detailMessage
String String String String

Uma mensagem detalhada a ser emitida.A detailed message to emit.

Exemplos

O exemplo a seguir usa Fail o método para imprimir uma mensagem durante a manipulação de exceção.The following example uses the Fail method to print a message during exception handling.

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

Você também pode usar o Fail método em uma instrução switch.You can also use the Fail method in a switch statement.

   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

Comentários

O comportamento padrão é que o DefaultTraceListener produz a mensagem em uma caixa de mensagem quando o aplicativo está sendo executado no modo de interface do TraceListener usuário e nas Listeners instâncias na coleção.The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.

Observação

A exibição da caixa de mensagem depende da presença do DefaultTraceListener.The display of the message box is dependent on the presence of the DefaultTraceListener. Se o DefaultTraceListener não estiver Listeners na coleção, a caixa de mensagem não será exibida.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. O DefaultTraceListener pode ser removido <por>CLEAR, Removeou>chamando o método na propriedade ( <). Clear Listeners System.Diagnostics.Trace.Listeners.Clear()The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Você pode personalizar esse comportamento adicionando um TraceListener ou removendo um da Listeners coleção.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Veja também

Aplica-se a