Condividi tramite


Trace.Assert Metodo

Definizione

Verifica la presenza di una condizione; se la condizione è false, restituisce messaggi e visualizza una finestra di messaggio che mostra lo stack di chiamate.

Overload

Nome Descrizione
Assert(Boolean)

Verifica la presenza di una condizione; se la condizione è false, visualizza una finestra di messaggio che mostra lo stack di chiamate.

Assert(Boolean, String)

Verifica la presenza di una condizione; se la condizione è false, restituisce un messaggio specificato e visualizza una finestra di messaggio che mostra lo stack di chiamate.

Assert(Boolean, String, String)

Verifica la presenza di una condizione; se la condizione è false, restituisce due messaggi specificati e visualizza una finestra di messaggio che mostra lo stack di chiamate.

Assert(Boolean)

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

Verifica la presenza di una condizione; se la condizione è false, visualizza una finestra di messaggio che mostra lo stack di chiamate.

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition);
[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit
[<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, non viene inviato un messaggio di errore 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, il codice chiama Assert per verificare che il valore di indice sia valido. Se non è valido, restituisce Assert lo stack di chiamate.

// 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 Interrompi viene terminata l'applicazione. Facendo clic su Riprova si invia 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.

Annotazioni

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. DefaultTraceListener Se non è presente nell'insiemeListeners, 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 corrispondente 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)

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

Verifica la presenza di una condizione; se la condizione è false, restituisce un messaggio specificato e visualizza una finestra di messaggio che mostra 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 = default);
[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, Optional message As String = Nothing)
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 Listeners raccolta.

Attributi

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

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 Interrompi viene terminata l'applicazione. Facendo clic su Riprova si invia 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.

Annotazioni

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. DefaultTraceListener Se non è presente nell'insiemeListeners, 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 corrispondente 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, String)

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

Verifica la presenza di una condizione; se la condizione è false, restituisce due messaggi specificati e visualizza una finestra di messaggio che mostra 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 Listeners raccolta.

detailMessage
String

Messaggio dettagliato da inviare alla Listeners raccolta.

Attributi

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)
{
    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 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 un 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 Interrompi viene terminata l'applicazione. Facendo clic su Riprova si invia 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.

Annotazioni

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. DefaultTraceListener Se non è presente nell'insiemeListeners, 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 corrispondente 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