Trace.Assert Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.TraceSource.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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)

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

Esempio

Nell'esempio seguente viene creato un indice per una matrice. Viene quindi eseguita un'azione che imposta il valore dell'indice. Successivamente, il codice chiama Assert per verificare che il valore dell'indice sia valido. Se non è valido, restituisce Assert lo 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 Assert(Boolean) metodo viene usato per identificare gli errori logici durante lo 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 o TraceListener 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 di riga. La finestra di messaggio contiene tre pulsanti: Interrompi, Riprova e Ignora. Facendo clic sul pulsante Abort viene terminata l'applicazione. Facendo clic su Riprova viene inviato al codice nel debugger se l'applicazione è in esecuzione in un debugger o offre di aprire un debugger in caso contrario. Facendo clic su Ignora continua con l'istruzione successiva nel codice.

Nota

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

Per le app .NET Framework, è possibile modificare il comportamento di nel file di DefaultTraceListener configurazione che corrisponde al nome dell'applicazione. In questo file è possibile abilitare e disabilitare la finestra di messaggio assert 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)

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

Esempio

Nell'esempio seguente viene verificato che il type parametro sia valido. Se l'oggetto type passato è null, restituisce Assert 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

In genere, il Assert(Boolean, String) metodo viene usato per identificare gli errori logici durante lo 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 o TraceListener rimuovendone uno dalla Listeners raccolta.

Nota

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

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

Esempio

Nell'esempio seguente viene verificato che il type parametro è valido. Se l'oggetto passato è null, l'output type Assert 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

In genere, il Assert(Boolean, String, String) metodo viene usato per identificare gli errori logici durante lo 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 o TraceListener 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 di riga. La finestra di messaggio contiene tre pulsanti: Interrompi, Riprova 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 DefaultTraceListener Listeners 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 e l'elemento<clear> <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

Trace.Assert Metodo

Definizione

Overload

Assert(Boolean)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Assert(Boolean, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Assert(Boolean, String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive