Debug.Assert 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.

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden Meldungen ausgegeben und ein Meldungsfeld mit der Aufrufliste angezeigt.

Überlädt

Assert(Boolean)	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.
Assert(Boolean, String)	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.
Assert(Boolean, String, String)	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, werden zwei angegebene Meldungen ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.
Assert(Boolean, String, String, Object[])	Überprüft eine Bedingung. Wenn die Bedingung `false` ist, werden zwei angegebene Meldungen (einfach und formatiert) ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.

Assert(Boolean)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, wird weder eine Fehlermeldung gesendet noch das Meldungsfeld angezeigt.

Attribute: ConditionalAttribute

Beispiele

Im folgenden Beispiel wird ein Index für ein Array erstellt, eine Aktion zum Festlegen des Indexwerts ausgeführt und dann aufgerufen Assert , um zu bestätigen, dass der Indexwert gültig ist. Wenn er ungültig ist, Assert gibt die Aufrufliste aus.

// Create a local value.
int index;

// Perform some action that sets the local value.
index = -40;

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif

// Create an index for an array.
int index;

// Perform some action that sets the index.
index = -40;

// Test that the index value is valid.
Debug.Assert(index > -1);

' Create an index for an array.
Dim index As Integer

' Perform some action that sets the index.
index = -40

' Test that the index value is valid. 
Debug.Assert((index > - 1))

Hinweise

Standardmäßig funktioniert die Debug.Assert-Methode nur in Debugbuilds. Verwenden Sie die Trace.Assert -Methode, wenn Sie Assertionen in Releasebuilds durchführen möchten. Weitere Informationen finden Sie unter Assertionen in verwaltetem Code.

In der Regel wird die Assert(Boolean) -Methode verwendet, um Logikfehler während der Programmentwicklung zu identifizieren. Assert wertet die Bedingung aus. Wenn das Ergebnis lautet false, wird eine Fehlermeldung an die Listeners Auflistung gesendet. Sie können dieses Verhalten anpassen, indem Sie der Listeners Auflistung eine TraceListener hinzufügen oder daraus entfernen.

Wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, wird ein Meldungsfeld angezeigt, in dem die Aufrufliste mit Datei- und Zeilennummern angezeigt wird. Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, Wiederholen und Ignorieren. Wenn Sie auf die Schaltfläche Abbrechen klicken, wird die Anwendung beendet. Durch Klicken auf Wiederholen werden Sie zum Code im Debugger gesendet, wenn Ihre Anwendung in einem Debugger ausgeführt wird, oder bietet an, einen Debugger zu öffnen, falls dies nicht der Code ist. Das Klicken auf Ignorieren wird mit der nächsten Anweisung im Code fortgesetzt.

Hinweis

Windows 8.x-Apps unterstützen keine modalen Dialogfelder, sodass sie sich im Benutzeroberflächenmodus und im Modus der Nicht-Benutzeroberfläche verhalten. Die Nachricht wird im Debugmodus an die aktiven Ablaufverfolgungslistener geschrieben, oder es wird keine Nachricht im Releasemodus geschrieben.

Hinweis

Die Anzeige des Meldungsfelds hängt vom Vorhandensein von ab DefaultTraceListener. Wenn nicht DefaultTraceListener in der Listeners Auflistung enthalten ist, wird das Meldungsfeld nicht angezeigt. Kann DefaultTraceListener entfernt werden, indem die -Methode für Clear die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) aufgerufen wird. Für .NET Framework-Apps können Sie auch das <Clear-Element> und das Remove-Element> in der< Konfigurationsdatei Ihrer App verwenden.

Für .NET Framework-Apps können Sie das Verhalten von DefaultTraceListener in der Konfigurationsdatei ändern, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie das Meldungsfeld assert aktivieren und deaktivieren oder die DefaultTraceListener.LogFileName -Eigenschaft festlegen. Die Konfigurationsdatei sollte wie folgt formatiert sein:

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler -> unit

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, wird die angegebene Meldung nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: Debug.AssertInterpolatedStringHandler

Die an die Listeners-Auflistung zu sendende Meldung.

Attribute: ConditionalAttribute

Hinweise

Diese Überladung wurde in .NET 6 eingeführt, um die Leistung zu verbessern. Im Vergleich zu den Überladungen, die einen String Parameter annehmen, wertet diese Überladung nur interpolierte Zeichenfolgenformatelemente aus, wenn die Nachricht erforderlich ist.

In der Regel wird die Assert -Methode verwendet, um Logikfehler während der Programmentwicklung zu identifizieren. Assert wertet die Bedingung aus. Wenn das Ergebnis lautet false, wird die angegebene Diagnosenachricht an die Listeners Auflistung gesendet. Sie können dieses Verhalten anpassen, indem Sie der Listeners Auflistung eine TraceListener hinzufügen oder daraus entfernen.

Hinweis

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, String)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

public:
 static void Assert(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, wird die angegebene Meldung nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: String

Die an die Listeners-Auflistung zu sendende Meldung.

Attribute: ConditionalAttribute

Beispiele

Im folgenden Beispiel wird überprüft, ob der type Parameter gültig ist. Wenn type ist null, Assert gibt eine Nachricht aus.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}

public static void MyMethod(Type type, Type baseType)
{
    Debug.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Debug.Assert(Not (type Is Nothing), "Type parameter is null")
End Sub

Hinweise

Hinweis

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler * AssertInterpolatedStringHandler -> unit

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, wird die angegebene Meldung nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: Debug.AssertInterpolatedStringHandler

Die an die Listeners-Auflistung zu sendende Meldung.

detailMessage: Debug.AssertInterpolatedStringHandler

Die an die Listeners-Auflistung zu sendende ausführliche Meldung.

Attribute: ConditionalAttribute

Hinweise

Diese Überladung wurde in .NET 6 eingeführt, um die Leistung zu verbessern. Im Vergleich zu den Überladungen, die einen String Parameter annehmen, wertet diese Überladung alle interpolierten Zeichenfolgenformatierungselemente nur aus, wenn die Nachricht erforderlich ist.

Standardmäßig funktioniert die Debug.Assert-Methode nur in Debugbuilds. Verwenden Sie die Trace.Assert -Methode, wenn Sie Assertionen in Releasebuilds ausführen möchten. Weitere Informationen finden Sie unter Assertionen in verwaltetem Code.

In der Regel wird die Assert Methode verwendet, um Logikfehler während der Programmentwicklung zu identifizieren. Assert wertet die Bedingung aus. Wenn das Ergebnis lautet false, sendet es die angegebene Diagnosenachricht an die Listeners Auflistung. Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

Wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, wird ein Meldungsfeld angezeigt, das den Aufrufstapel mit Datei- und Zeilennummern anzeigt. Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, Wiederholen und Ignorieren. Durch Klicken auf die Schaltfläche Abbrechen wird die Anwendung beendet. Wenn Sie auf Wiederholen klicken, werden Sie zum Code im Debugger gesendet, wenn Ihre Anwendung in einem Debugger ausgeführt wird, oder bietet an, einen Debugger zu öffnen, falls nicht. Das Klicken auf Ignorieren wird mit der nächsten Anweisung im Code fortgesetzt.

Hinweis

Die Anzeige des Meldungsfelds hängt vom Vorhandensein von DefaultTraceListenerab. Wenn sich der DefaultTraceListener nicht in der Listeners Auflistung befindet, wird das Meldungsfeld nicht angezeigt. Die DefaultTraceListener kann entfernt werden, indem Sie die Clear -Methode für die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) aufrufen. Für .NET Framework Apps können Sie auch das <clear-Element> und das remove-Element> in der< Konfigurationsdatei Ihrer App verwenden.

Für .NET Framework Apps können Sie das Verhalten von DefaultTraceListener in der Konfigurationsdatei ändern, das dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie das Meldungsfeld assert aktivieren und deaktivieren oder die DefaultTraceListener.LogFileName -Eigenschaft festlegen. Die Konfigurationsdatei sollte wie folgt formatiert sein:

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, String, String)

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string? detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, werden die angegebenen Meldungen nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: String

Die an die Listeners-Auflistung zu sendende Meldung.

detailMessage: String

Die an die Listeners-Auflistung zu sendende ausführliche Meldung.

Attribute: ConditionalAttribute

Beispiele

Im folgenden Beispiel wird überprüft, ob der type Parameter gültig ist. Wenn type ist null, Assert gibt zwei Nachrichten aus.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}

public static void MyMethod(Type type, Type baseType)
{
    Debug.Assert(type != null, "Type parameter is null",
       "Can't get object for null type");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Debug.Assert( Not (type Is Nothing), "Type parameter is null", "Can't get object for null type")
    ' Perform some processing.
End Sub

Hinweise

In der Regel wird die Assert(Boolean, String, String) Methode verwendet, um Logikfehler während der Programmentwicklung zu identifizieren. Assert wertet die Bedingung aus. Wenn das Ergebnis lautet false, sendet es die angegebene Diagnosenachricht und eine detaillierte Nachricht an die Listeners Auflistung. Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

Hinweis

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, String, String, Object[])

Quelle:: Debug.cs

Quelle:: Debug.cs

Quelle:: Debug.cs

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen (einfach und formatiert) ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string detailMessageFormat, params object?[] args);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string * obj[] -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung true ist, werden die angegebenen Meldungen nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: String

Die an die Listeners-Auflistung zu sendende Meldung.

detailMessageFormat: String

Die zusammengesetzte Formatzeichenfolge, die an die Listeners-Auflistung gesendet werden soll. Diese Meldung enthält Text und optional ein oder mehrere Formatelemente, die Objekten im args-Array entsprechen.

args: Object[]

Ein Objektarray mit 0 (null) oder mehr zu formatierenden Objekten.

Attribute: ConditionalAttribute

Hinweise

Diese Methode verwendet die zusammengesetzte .NET-Formatierungsfunktion , um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird an die Listeners Auflistung gesendet.

In der Regel wird die Assert(Boolean, String, String, Object[]) Methode verwendet, um Logikfehler während der Programmentwicklung zu identifizieren. Assert wertet die Bedingung aus. Wenn das Ergebnis lautetfalse, wird die String.Format(String, Object[]) -Methode aufgerufen, und die Zeichenfolge und args das detailMessageFormat Array werden als Parameter übergeben. Assert(Boolean, String, String, Object[]) sendet dann die angegebene Textnachricht und die formatierte Textnachricht an die Listeners Auflistung. Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

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 entfernt werden, indem Sie die Clear -Methode für die Listeners -Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) aufrufen. Für .NET Framework Apps können Sie auch das <clear-Element> und das remove-Element> in der< Konfigurationsdatei Ihrer App verwenden.

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Gilt für:

Freigeben über

Debug.Assert Methode

Definition

Überlädt

Assert(Boolean)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, String, String, Object[])

Parameter

Hinweise

Gilt für:

Zusätzliche Ressourcen