Trace.Assert Methode

Referenz

Definition

Namespace:: System.Diagnostics

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.

Ü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, 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, 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)

Quelle:: Trace.cs

Quelle:: Trace.cs

Quelle:: Trace.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("TRACE")]
public static void Assert (bool condition);

[<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 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. Anschließend wird eine Aktion ausgeführt, die den Wert des Indexes festlegt. Als Nächstes wird der Code aufgerufen Assert , um zu überprüfen, ob der Indexwert gültig ist. Wenn sie ungültig ist, gibt die Assert Aufrufliste aus.

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

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }

// 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 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>  
    <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

Ü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("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, 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 das type übergebene ist, gibt nulldie Assert eine Nachricht aus.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }

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 Auflistung. Sie können dieses Verhalten anpassen, indem Sie der Auflistung eine TraceListener hinzufügen oder aus entfernen Listeners .

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

Ü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("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 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 das type übergebene ist, gibt nulldie Assert eine Nachricht aus.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }

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 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>  
    <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:

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:

Zusätzliche Ressourcen