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

Definizione

Controlla una condizione. Se la condizione è false, vengono generati messaggi e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Overload

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

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.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)

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.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)

Controlla una condizione. Se la condizione è false, vengono generati due messaggi specificati e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.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)

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.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)

Parametri

condition
Boolean Boolean Boolean Boolean

Espressione condizionale da valutare.The conditional expression to evaluate. Se la condizione è true, non viene inviato un messaggio di errore e la finestra di messaggio non viene visualizzata.If the condition is true, a failure message is not sent and the message box is not displayed.

Esempi

Nell'esempio seguente viene creato un indice per una matrice.The following example creates an index for an array. Viene quindi eseguita un'azione che imposta il valore dell'indice.Then some action is performed that sets the value of the index. Successivamente, il codice Assert chiama per verificare che il valore di indice sia valido.Next the code calls Assert to verify the index value is valid. Se non è valido, il Assert restituisce lo stack di chiamate.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

Commenti

Utilizzare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di rilascio.Use the Trace.Assert method if you want to do assertions in release builds. Il Debug.Assert metodo funziona solo nelle compilazioni di debug.The Debug.Assert method works only in debug builds. Per ulteriori informazioni, vedere Asserzioni nel metodo gestito.For more information, see Assertions in Managed Code.

In genere, Assert(Boolean) il metodo viene usato per identificare gli errori di logica durante lo sviluppo del programma.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert(Boolean)valuta la condizione.Assert(Boolean) evaluates the condition. Se il risultato è false, viene inviato un messaggio Listeners di errore alla raccolta.If the result is false, it sends a failure message to the Listeners collection. È possibile personalizzare questo comportamento aggiungendo o rimuovendo un oggetto TraceListener dalla Listeners raccolta.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con i numeri di riga e file.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. La finestra di messaggio contiene tre pulsanti: **** Interrompi ****, Riprova e Ignora.The message box contains three buttons: Abort, Retry, and Ignore. Quando si **** fa clic sul pulsante Interrompi viene terminata l'applicazione.Clicking the Abort button terminates the application. Se **** si fa clic su Riprova, viene inviato il codice nel debugger se l'applicazione è in esecuzione in un debugger o se non è possibile aprire un debugger.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. Fare clic su Ignora continua con l'istruzione successiva nel codice.Clicking Ignore continues with the next instruction in the code.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Se l' DefaultTraceListener oggetto non è presente Listeners nella raccolta, la finestra di messaggio non viene visualizzata.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. L' DefaultTraceListener oggetto può essere rimosso <dall'oggetto>Clear, <dall'oggetto Remove>oppure chiamando il Clear metodo sullaSystem.Diagnostics.Trace.Listeners.Clear()Proprietà(). ListenersThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

È possibile modificare il comportamento di DefaultTraceListener nel file di configurazione che corrisponde al nome dell'applicazione.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In questo file è possibile abilitare e disabilitare la finestra di messaggio Assert o impostare la DefaultTraceListener.LogFileName proprietà.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Il file di configurazione deve essere formattato come segue: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>  
Vedi anche

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

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.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)

Parametri

condition
Boolean Boolean Boolean Boolean

Espressione condizionale da valutare.The conditional expression to evaluate. Se la condizione è true, il messaggio specificato non viene inviato e la finestra di messaggio non viene visualizzata.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String String String String

Messaggio da inviare alla raccolta di Listeners.The message to send to the Listeners collection.

Esempi

Nell'esempio seguente viene verificato come verificare che type il parametro sia valido.The following example checks to see that the type parameter is valid. Se l' type oggetto passato è null, Assert restituisce un messaggio.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

Commenti

Utilizzare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di rilascio.Use the Trace.Assert method if you want to do assertions in release builds. Il Debug.Assert metodo funziona solo nelle compilazioni di debug.The Debug.Assert method works only in debug builds. Per ulteriori informazioni, vedere Asserzioni nel metodo gestito.For more information, see Assertions in Managed Code.

In genere, Assert(Boolean, String) il metodo viene usato per identificare gli errori di logica durante lo sviluppo del programma.Typically, the Assert(Boolean, String) method is used to identify logic errors during program development. Assert(Boolean, String)valuta la condizione.Assert(Boolean, String) evaluates the condition. Se il risultato è false, invia il messaggio Listeners di diagnostica specificato alla raccolta.If the result is false, it sends the specified diagnostic message to the Listeners collection. È possibile personalizzare questo comportamento aggiungendo o rimuovendo un oggetto TraceListener dalla Listeners raccolta.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con i numeri di riga e file.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. La finestra di messaggio contiene tre pulsanti: **** Interrompi ****, Riprova e Ignora.The message box contains three buttons: Abort, Retry, and Ignore. Quando si **** fa clic sul pulsante Interrompi viene terminata l'applicazione.Clicking the Abort button terminates the application. Se **** si fa clic su Riprova, viene inviato il codice nel debugger se l'applicazione è in esecuzione in un debugger o se non è possibile aprire un debugger.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. Fare clic su Ignora continua con l'istruzione successiva nel codice.Clicking Ignore continues with the next instruction in the code.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Se l' DefaultTraceListener oggetto non è presente Listeners nella raccolta, la finestra di messaggio non viene visualizzata.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. L' DefaultTraceListener oggetto può essere rimosso <dall'oggetto>Clear, <dall'oggetto Remove>oppure chiamando il Clear metodo sullaSystem.Diagnostics.Trace.Listeners.Clear()Proprietà(). ListenersThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

È possibile modificare il comportamento di DefaultTraceListener nel file di configurazione che corrisponde al nome dell'applicazione.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In questo file è possibile abilitare e disabilitare la finestra di messaggio Assert o impostare la DefaultTraceListener.LogFileName proprietà.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Il file di configurazione deve essere formattato come segue: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>  
Vedi anche

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

Controlla una condizione. Se la condizione è false, vengono generati due messaggi specificati e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.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)

Parametri

condition
Boolean Boolean Boolean Boolean

Espressione condizionale da valutare.The conditional expression to evaluate. Se la condizione è true, i messaggi specificati non vengono inviati e la finestra di messaggio non viene visualizzata.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String String String String

Messaggio da inviare alla raccolta di Listeners.The message to send to the Listeners collection.

detailMessage
String String String String

Messaggio dettagliato da inviare all'insieme Listeners.The detailed message to send to the Listeners collection.

Esempi

Nell'esempio seguente viene verificato come verificare che type il parametro sia valido.The following example checks to see that the type parameter is valid. Se l' type oggetto passato è null, Assert restituisce un messaggio.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

Commenti

Utilizzare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di rilascio.Use the Trace.Assert method if you want to do assertions in release builds. Il Debug.Assert metodo funziona solo nelle compilazioni di debug.The Debug.Assert method works only in debug builds. Per ulteriori informazioni, vedere Asserzioni nel metodo gestito.For more information, see Assertions in Managed Code.

In genere, Assert(Boolean, String, String) il metodo viene usato per identificare gli errori di logica durante lo sviluppo del programma.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assertvaluta la condizione.Assert evaluates the condition. Se il risultato è false, invia il messaggio Listeners di diagnostica specificato e il messaggio dettagliato alla raccolta.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. È possibile personalizzare questo comportamento aggiungendo o rimuovendo un oggetto TraceListener dalla Listeners raccolta.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con i numeri di riga e file.When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. La finestra di messaggio contiene tre pulsanti: **** Interrompi ****, Riprova e Ignora.The message box contains three buttons: Abort, Retry, and Ignore. Quando si **** fa clic sul pulsante Interrompi viene terminata l'applicazione.Clicking the Abort button terminates the application. Se **** si fa clic su Riprova, viene inviato il codice nel debugger se l'applicazione è in esecuzione in un debugger o se non è possibile aprire un debugger.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. Fare clic su Ignora continua con l'istruzione successiva nel codice.Clicking Ignore continues with the next instruction in the code.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Se l' DefaultTraceListener oggetto non è presente Listeners nella raccolta, la finestra di messaggio non viene visualizzata.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. L' DefaultTraceListener oggetto può essere rimosso <dall'oggetto>Clear, <dall'oggetto Remove>oppure chiamando il Clear metodo sullaSystem.Diagnostics.Trace.Listeners.Clear()Proprietà(). ListenersThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

È possibile modificare il comportamento di DefaultTraceListener nel file di configurazione che corrisponde al nome dell'applicazione.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. In questo file è possibile abilitare e disabilitare la finestra di messaggio Assert o impostare la DefaultTraceListener.LogFileName proprietà.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Il file di configurazione deve essere formattato come segue: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>  
Vedi anche

Si applica a