Trace.Assert Methode

Definition

Namespace:: System.Diagnostics

Assemblys:: netstandard.dll, System.Diagnostics.TraceSource.dll

Assembly:: System.Diagnostics.TraceSource.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.

Sucht nach einer Bedingung; wenn die Bedingung lautet false, gibt Nachrichten aus und zeigt ein Meldungsfeld an, in dem der Aufrufstapel angezeigt wird.

Überlädt

Name	Beschreibung
Assert(Boolean)	Sucht nach einer Bedingung; wenn die Bedingung lautet `false`, wird ein Meldungsfeld mit dem Aufrufstapel angezeigt.
Assert(Boolean, String)	Sucht nach einer Bedingung; wenn die Bedingung lautet `false`, gibt eine angegebene Nachricht aus und zeigt ein Meldungsfeld an, in dem der Aufrufstapel angezeigt wird.
Assert(Boolean, String, String)	Sucht nach einer Bedingung; wenn die Bedingung lautet `false`, gibt zwei angegebene Nachrichten aus und zeigt ein Meldungsfeld an, in dem der Aufrufstapel angezeigt wird.

Assert(Boolean)

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Sucht nach einer Bedingung; wenn die Bedingung lautet false, wird ein Meldungsfeld mit dem Aufrufstapel angezeigt.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

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

[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

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

Public Shared Sub Assert (condition As Boolean)

Parameter

condition: Boolean

Der auszuwertende bedingte Ausdruck. Wenn die Bedingung lautet true, wird keine Fehlermeldung gesendet, und das Meldungsfeld wird nicht angezeigt.

Attribute: ConditionalAttribute OverloadResolutionPriorityAttribute

Beispiele

Im folgenden Beispiel wird ein Index für ein Array erstellt. Anschließend wird eine Aktion ausgeführt, die den Wert des Indexes festlegt. Als Nächstes ruft der Code auf Assert , um zu überprüfen, ob der Indexwert gültig ist. Wenn sie ungültig ist, gibt die Assert Ausgabe des Aufrufstapels aus.

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

void Method()
{
    // Perform some action that sets the index.

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

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

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Hinweise

Verwenden Sie die Trace.Assert Methode, wenn Sie Assertionen in Releasebuilds ausführen möchten. Die Debug.Assert Methode funktioniert nur in Debugbuilds. 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(Boolean) wertet die Bedingung aus. Wenn das Ergebnis lautet false, sendet es eine Fehlermeldung an die Listeners Sammlung. Sie können dieses Verhalten anpassen, indem Sie eine TraceListener der Auflistung hinzufügen oder aus dieser Listeners entfernen.

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

Hinweis

Die Anzeige des Meldungsfelds hängt vom Vorhandensein des Kontrollkästchens DefaultTraceListenerab. Wenn sich die DefaultTraceListener Listeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch Aufrufen der Clear Methode für die Listeners Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) entfernt werden. 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 der DefaultTraceListener 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 werden:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, String)

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Sucht nach einer Bedingung; wenn die Bedingung lautet false, gibt eine angegebene Nachricht aus und zeigt ein Meldungsfeld an, in dem der Aufrufstapel angezeigt wird.

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

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

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

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

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

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

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

Parameter

condition: Boolean

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

message: String

Die Nachricht, die an die Listeners Sammlung gesendet werden soll.

Attribute: ConditionalAttribute

Beispiele

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

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

    // Perform some processing.
}

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

    ' Perform some processing.
End Sub

Hinweise

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

Hinweis

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Assert(Boolean, String, String)

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.cs

Sucht nach einer Bedingung; wenn die Bedingung lautet false, gibt zwei angegebene Nachrichten aus und zeigt ein Meldungsfeld an, in dem der Aufrufstapel angezeigt wird.

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

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

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

[<System.Diagnostics.Conditional("TRACE")>]
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 lautet true, werden die angegebenen Nachrichten nicht gesendet, und das Meldungsfeld wird nicht angezeigt.

message: String

Die Nachricht, die an die Listeners Sammlung gesendet werden soll.

detailMessage: String

Die detaillierte Nachricht, die an die Listeners Sammlung gesendet werden soll.

Attribute: ConditionalAttribute

Beispiele

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

public static void MyMethod(Type type, Type baseType)
{
    Trace.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)
    Trace.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 detaillierte Nachricht an die Listeners Sammlung. Sie können dieses Verhalten anpassen, indem Sie eine TraceListener der Auflistung hinzufügen oder aus dieser Listeners entfernen.

Hinweis

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

Trace.Assert Methode

Definition

Überlädt

Assert(Boolean)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Assert(Boolean, String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback