Trace.Assert Trace.Assert Trace.Assert Trace.Assert Method

Definition

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden Meldungen ausgegeben und ein Meldungsfeld mit der Aufrufliste angezeigt.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Überlädt

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine bestimmte Meldung ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition);
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

Parameter

condition
Boolean Boolean Boolean Boolean

Der auszuwertende bedingte Ausdruck.The conditional expression to evaluate. Wenn die Bedingung true ist, wird weder eine Fehlermeldung gesendet noch das Meldungsfeld angezeigt.If the condition is true, a failure message is not sent and the message box is not displayed.

Beispiele

Das folgende Beispiel erstellt einen Index für ein Array.The following example creates an index for an array. Anschließend wird eine Aktion ausgeführt, die den Wert des Indexes festlegt.Then some action is performed that sets the value of the index. Als Nächstes ruft der Code Assert Wert um zu überprüfen, ob den Index ist gültig.Next the code calls Assert to verify the index value is valid. Wenn es nicht gültig ist, ist die Assert gibt die Aufrufliste.If it is not valid, the Assert outputs the call stack.

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.
 protected int index;
 
 protected 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 der Trace.Assert erstellt der Methode, wenn Sie Assertionen, die in Version durchführen möchten.Use the Trace.Assert method if you want to do assertions in release builds. Die Debug.Assert Methode funktioniert nur in Debug-Builds.The Debug.Assert method works only in debug builds. Weitere Informationen finden Sie unter Assertionen in verwaltetem Code.For more information, see Assertions in Managed Code.

In der Regel die Assert(Boolean) Methode wird verwendet, um Logikfehler während der Programmentwicklung zu identifizieren.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert(Boolean) wertet die Bedingung an.Assert(Boolean) evaluates the condition. Wenn das Ergebnis ist false, sendet er eine Fehlermeldung, die Listeners Auflistung.If the result is false, it sends a failure message to the Listeners collection. Sie können dieses Verhalten anpassen, durch das Hinzufügen einer TraceListener , oder Entfernen aus, die Listeners Auflistung.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, wird ein Meldungsfeld an, die der Aufrufliste mit und die Zeilennummer an.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, wiederholen, und ignorieren.The message box contains three buttons: Abort, Retry, and Ignore. Klicken auf die Abbrechen Schaltfläche wird die Anwendung beendet.Clicking the Abort button terminates the application. Auf wiederholen sendet Sie an den Code im Debugger, wenn Ihre Anwendung in einem Debugger ausgeführt wird, oder um einen Debugger zu öffnen, ist dies nicht bietet.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Auf ignorieren mit der nächsten Anweisung im Code fortgesetzt.Clicking Ignore continues with the next instruction in the code.

Hinweis

Die Anzeige des Meldungsfelds hängt das Vorhandensein der DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Wenn die DefaultTraceListener befindet sich nicht in der Listeners -Auflistung, das Meldungsfeld wird nicht angezeigt.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. Die DefaultTraceListener entfernt werden kann die <löschen>, <entfernen>, oder durch Aufrufen der Clear Methode für die Listeners Eigenschaft (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()).

Sie können das Verhalten des Ändern der DefaultTraceListener in der Konfigurationsdatei, die den Namen der Anwendung entspricht.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In dieser Datei können Sie aktivieren und deaktivieren Sie das Meldungsfeld Assert oder Festlegen der DefaultTraceListener.LogFileName Eigenschaft.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Die Konfigurationsdatei sollte wie folgt formatiert sein:The configuration file should be formatted as follows:

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

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine bestimmte Meldung ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

Parameter

condition
Boolean Boolean Boolean Boolean

Der auszuwertende bedingte Ausdruck.The conditional expression to evaluate. Wenn die Bedingung true ist, wird keine Meldung gesendet und kein Meldungsfeld angezeigt.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String String String String

Die Nachricht, die an die Listeners-Auflistung gesendet werden soll.The message to send to the Listeners collection.

Beispiele

Im folgenden Beispiel wird überprüft, ob die type Parameter ist ungültig.The following example checks to see that the type parameter is valid. Wenn die type übergebenen ist null, Assert eine Meldung ausgibt.If the type passed in is null, the Assert outputs a message.

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

Verwenden der Trace.Assert erstellt der Methode, wenn Sie Assertionen, die in Version durchführen möchten.Use the Trace.Assert method if you want to do assertions in release builds. Die Debug.Assert Methode funktioniert nur in Debug-Builds.The Debug.Assert method works only in debug builds. Weitere Informationen finden Sie unter Assertionen in verwaltetem Code.For more information, see Assertions in Managed Code.

In der Regel die Assert(Boolean, String) Methode wird verwendet, um Logikfehler während der Programmentwicklung zu identifizieren.Typically, the Assert(Boolean, String) method is used to identify logic errors during program development. Assert(Boolean, String) wertet die Bedingung an.Assert(Boolean, String) evaluates the condition. Wenn das Ergebnis ist false, sendet er die angegebene diagnosemeldung aus, um die Listeners Auflistung.If the result is false, it sends the specified diagnostic message to the Listeners collection. Sie können dieses Verhalten anpassen, durch das Hinzufügen einer TraceListener , oder Entfernen aus, die Listeners Auflistung.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, wird ein Meldungsfeld an, die der Aufrufliste mit und die Zeilennummer an.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, wiederholen, und ignorieren.The message box contains three buttons: Abort, Retry, and Ignore. Klicken auf die Abbrechen Schaltfläche wird die Anwendung beendet.Clicking the Abort button terminates the application. Auf wiederholen sendet Sie an den Code im Debugger, wenn Ihre Anwendung in einem Debugger ausgeführt wird, oder um einen Debugger zu öffnen, ist dies nicht bietet.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Auf ignorieren mit der nächsten Anweisung im Code fortgesetzt.Clicking Ignore continues with the next instruction in the code.

Hinweis

Die Anzeige des Meldungsfelds hängt das Vorhandensein der DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Wenn die DefaultTraceListener befindet sich nicht in der Listeners -Auflistung, das Meldungsfeld wird nicht angezeigt.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. Die DefaultTraceListener entfernt werden kann die <löschen>, <entfernen>, oder durch Aufrufen der Clear Methode für die Listeners Eigenschaft (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()).

Sie können das Verhalten des Ändern der DefaultTraceListener in der Konfigurationsdatei, die den Namen der Anwendung entspricht.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In dieser Datei können Sie aktivieren und deaktivieren Sie das Meldungsfeld Assert oder Festlegen der DefaultTraceListener.LogFileName Eigenschaft.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Die Konfigurationsdatei sollte wie folgt formatiert sein:The configuration file should be formatted as follows:

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

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

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);
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Parameter

condition
Boolean Boolean Boolean Boolean

Der auszuwertende bedingte Ausdruck.The conditional expression to evaluate. Wenn die Bedingung true ist, werden die angegebenen Meldungen nicht gesendet, und das Meldungsfeld wird nicht angezeigt.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String String String String

Die Nachricht, die an die Listeners-Auflistung gesendet werden soll.The message to send to the Listeners collection.

detailMessage
String String String String

Die detaillierte Nachricht, die an die Listeners-Auflistung gesendet werden soll.The detailed message to send to the Listeners collection.

Beispiele

Im folgenden Beispiel wird überprüft, ob die type Parameter ist ungültig.The following example checks to see that the type parameter is valid. Wenn die type übergebenen ist null, Assert eine Meldung ausgibt.If the type passed in is null, the Assert outputs a message.

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

Verwenden der Trace.Assert erstellt der Methode, wenn Sie Assertionen, die in Version durchführen möchten.Use the Trace.Assert method if you want to do assertions in release builds. Die Debug.Assert Methode funktioniert nur in Debug-Builds.The Debug.Assert method works only in debug builds. Weitere Informationen finden Sie unter Assertionen in verwaltetem Code.For more information, see Assertions in Managed Code.

In der Regel die Assert(Boolean, String, String) Methode wird verwendet, um Logikfehler während der Programmentwicklung zu identifizieren.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assert wertet die Bedingung an.Assert evaluates the condition. Wenn das Ergebnis ist false, er sendet die angegebene diagnosemeldung und detaillierte Meldung, die die Listeners Auflistung.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. Sie können dieses Verhalten anpassen, durch das Hinzufügen einer TraceListener , oder Entfernen aus, die Listeners Auflistung.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird, wird ein Meldungsfeld an, die der Aufrufliste mit und die Zeilennummer an.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, wiederholen, und ignorieren.The message box contains three buttons: Abort, Retry, and Ignore. Klicken auf die Abbrechen Schaltfläche wird die Anwendung beendet.Clicking the Abort button terminates the application. Auf wiederholen sendet Sie an den Code im Debugger, wenn Ihre Anwendung in einem Debugger ausgeführt wird, oder um einen Debugger zu öffnen, ist dies nicht bietet.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Auf ignorieren mit der nächsten Anweisung im Code fortgesetzt.Clicking Ignore continues with the next instruction in the code.

Hinweis

Die Anzeige des Meldungsfelds hängt das Vorhandensein der DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Wenn die DefaultTraceListener befindet sich nicht in der Listeners -Auflistung, das Meldungsfeld wird nicht angezeigt.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. Die DefaultTraceListener entfernt werden kann die <löschen>, <entfernen>, oder durch Aufrufen der Clear Methode für die Listeners Eigenschaft (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()).

Sie können das Verhalten des Ändern der DefaultTraceListener in der Konfigurationsdatei, die den Namen der Anwendung entspricht.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In dieser Datei können Sie aktivieren und deaktivieren Sie das Meldungsfeld Assert oder Festlegen der DefaultTraceListener.LogFileName Eigenschaft.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Die Konfigurationsdatei sollte wie folgt formatiert sein:The configuration file should be formatted as follows:

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

Gilt für: