Trace.Assert Metodo

Definizione

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

Overload

Assert(Boolean)

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

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.

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.

Assert(Boolean)

Origine:
Trace.cs
Origine:
Trace.cs
Origine:
Trace.cs

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

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)

Parametri

condition
Boolean

Espressione condizionale da valutare. Se la condizione è true, il messaggio di errore non viene inviato e la finestra di messaggio non viene visualizzata.

Attributi

Esempio

Nell'esempio seguente viene creato un indice per una matrice. Viene quindi eseguita un'azione che imposta il valore dell'indice. Successivamente, le chiamate Assert di codice per verificare che il valore dell'indice sia valido. Se non è valida, l'output dello Assert stack di chiamate.

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

Commenti

Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Il Debug.Assert metodo funziona solo nelle compilazioni di debug. Per altre informazioni, vedere Asserzioni nel codice gestito.

In genere, il metodo viene usato per identificare gli errori della logica durante lo Assert(Boolean) sviluppo del programma. Assert(Boolean) valuta la condizione. Se il risultato è false, invia un messaggio di errore alla Listeners raccolta. È possibile personalizzare questo comportamento aggiungendo un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con numeri di file e riga. La finestra di messaggio contiene tre pulsanti: Interruzione, Ripetizione tentativi e Ignora. Facendo clic sul pulsante Abort termina l'applicazione. Facendo clic su Riprova si invia al codice nel debugger se l'applicazione è in esecuzione in un debugger o offre l'apertura di un debugger se non è. Facendo clic su Ignora continua con l'istruzione successiva nel codice.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. Se l'oggetto DefaultTraceListenerListeners non è presente nella raccolta, la finestra di messaggio non viene visualizzata. L'oggetto DefaultTraceListener può essere rimosso chiamando il Clear metodo nella Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()). Per le app .NET Framework, è anche possibile usare l'elemento< chiaro> e l'elemento< remove> nel file di configurazione dell'app.

Per le app .NET Framework, è possibile modificare il comportamento del file di DefaultTraceListener configurazione corrispondente al nome dell'applicazione. In questo file è possibile abilitare e disabilitare la casella di messaggio asserzione o impostare la DefaultTraceListener.LogFileName proprietà. Il file di configurazione deve essere formattato come segue:

<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

Assert(Boolean, String)

Origine:
Trace.cs
Origine:
Trace.cs
Origine:
Trace.cs

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.

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)

Parametri

condition
Boolean

Espressione condizionale da valutare. Se la condizione è true, il messaggio specificato non viene inviato e la finestra di messaggio non viene visualizzata.

message
String

Messaggio da inviare alla raccolta di Listeners.

Attributi

Esempio

Nell'esempio seguente viene verificato che il type parametro è valido. Se l'oggetto passato è null, l'output typeAssert di un messaggio.

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

Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Il Debug.Assert metodo funziona solo nelle compilazioni di debug. Per altre informazioni, vedere Asserzioni nel codice gestito.

In genere, il metodo viene usato per identificare gli errori della logica durante lo Assert(Boolean, String) sviluppo del programma. Assert(Boolean, String) valuta la condizione. Se il risultato è false, invia il messaggio di diagnostica specificato alla Listeners raccolta. È possibile personalizzare questo comportamento aggiungendo un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con numeri di file e riga. La finestra di messaggio contiene tre pulsanti: Interruzione, Ripetizione tentativi e Ignora. Facendo clic sul pulsante Abort termina l'applicazione. Facendo clic su Riprova si invia al codice nel debugger se l'applicazione è in esecuzione in un debugger o offre l'apertura di un debugger se non è. Facendo clic su Ignora continua con l'istruzione successiva nel codice.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. Se l'oggetto DefaultTraceListenerListeners non è presente nella raccolta, la finestra di messaggio non viene visualizzata. L'oggetto DefaultTraceListener può essere rimosso chiamando il Clear metodo nella Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()). Per le app .NET Framework, è anche possibile usare l'elemento< chiaro> e l'elemento< remove> nel file di configurazione dell'app.

Per le app .NET Framework, è possibile modificare il comportamento del file di DefaultTraceListener configurazione corrispondente al nome dell'applicazione. In questo file è possibile abilitare e disabilitare la casella di messaggio asserzione o impostare la DefaultTraceListener.LogFileName proprietà. Il file di configurazione deve essere formattato come segue:

<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

Assert(Boolean, String, String)

Origine:
Trace.cs
Origine:
Trace.cs
Origine:
Trace.cs

Controlla una condizione. Se la condizione è false, vengono generati due messaggi specificati e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

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)

Parametri

condition
Boolean

Espressione condizionale da valutare. Se la condizione è true, i messaggi specificati non vengono inviati e la finestra di messaggio non viene visualizzata.

message
String

Messaggio da inviare alla raccolta di Listeners.

detailMessage
String

Messaggio dettagliato da inviare alla raccolta di Listeners.

Attributi

Esempio

Nell'esempio seguente viene verificato che il type parametro è valido. Se l'oggetto passato è null, l'output typeAssert di un messaggio.

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

Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Il Debug.Assert metodo funziona solo nelle compilazioni di debug. Per altre informazioni, vedere Asserzioni nel codice gestito.

In genere, il metodo viene usato per identificare gli errori della logica durante lo Assert(Boolean, String, String) sviluppo del programma. Assert valuta la condizione. Se il risultato è false, invia il messaggio di diagnostica specificato e il messaggio dettagliato alla Listeners raccolta. È possibile personalizzare questo comportamento aggiungendo un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Quando l'applicazione viene eseguita in modalità interfaccia utente, viene visualizzata una finestra di messaggio che mostra lo stack di chiamate con numeri di file e riga. La finestra di messaggio contiene tre pulsanti: Interruzione, Ripetizione tentativi e Ignora. Facendo clic sul pulsante Abort termina l'applicazione. Facendo clic su Riprova si invia al codice nel debugger se l'applicazione è in esecuzione in un debugger o offre l'apertura di un debugger se non è. Facendo clic su Ignora continua con l'istruzione successiva nel codice.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. Se l'oggetto DefaultTraceListenerListeners non è presente nella raccolta, la finestra di messaggio non viene visualizzata. L'oggetto DefaultTraceListener può essere rimosso chiamando il Clear metodo nella Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()). Per le app .NET Framework, è anche possibile usare l'elemento< chiaro> e l'elemento< remove> nel file di configurazione dell'app.

Per le app .NET Framework, è possibile modificare il comportamento del file di DefaultTraceListener configurazione corrispondente al nome dell'applicazione. In questo file è possibile abilitare e disabilitare la casella di messaggio asserzione o impostare la DefaultTraceListener.LogFileName proprietà. Il file di configurazione deve essere formattato come segue:

<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