Debug.Fail Methode

Referenz

Definition

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.Debug.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt eine Fehlermeldung aus.

Überlädt

Fail(String, String)	Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung aus.
Fail(String)	Gibt die angegebene Fehlermeldung aus.

Fail(String, String)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung aus.

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")]
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)

Parameter

message: String

Eine auszugebende Meldung.

detailMessage: String

Eine detaillierte Meldung, die ausgegeben werden soll.

Attribute: ConditionalAttribute

Beispiele

Im folgenden Beispiel wird die Fail -Methode zum Drucken einer Nachricht während der Ausnahmebehandlung verwendet.

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

Sie können die Fail -Methode auch in einer switch-Anweisung verwenden.

   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

Hinweise

Das Standardverhalten besteht darin, dass die DefaultTraceListener Nachricht an ein Meldungsfeld ausgegeben wird, wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, und an die TraceListener Instanzen in der Listeners Auflistung.

Hinweis

Die Anzeige des Meldungsfelds ist abhängig vom Vorhandensein von DefaultTraceListener. Wenn sich der DefaultTraceListener nicht in der Listeners Auflistung befindet, wird das Meldungsfeld nicht angezeigt. Die DefaultTraceListener kann durch clear<>, remove<> oder durch Aufrufen der Clear -Methode für die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) entfernt werden.

Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

Weitere Informationen

Gilt für:

Fail(String)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Gibt die angegebene Fehlermeldung aus.

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (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)

Parameter

message: String

Eine auszugebende Meldung.

Attribute: ConditionalAttribute

Beispiele

Im folgenden Beispiel wird die Fail -Methode zum Drucken einer Nachricht während der Ausnahmebehandlung verwendet.

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

Sie können die Fail -Methode auch in einer switch-Anweisung verwenden.

   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

Hinweise

Hinweis

Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

Weitere Informationen

Gilt für:

Freigeben über

Debug.Fail Methode

Definition

Überlädt

Fail(String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Fail(String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen