Debug.Assert Metodo
Definizione
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.
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 è |
| Assert(Boolean, Debug+AssertInterpolatedStringHandler) |
Verifica la presenza di una condizione; se la condizione è |
| Assert(Boolean, String) |
Verifica la presenza di una condizione; se la condizione è |
| Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler) |
Verifica la presenza di una condizione; se la condizione è |
| Assert(Boolean, String, String) |
Verifica la presenza di una condizione; se la condizione è |
| Assert(Boolean, String, String, Object[]) |
Verifica la presenza di una condizione; se la condizione è |
Assert(Boolean)
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.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("DEBUG")]
public static void Assert(bool condition);[System.Diagnostics.Conditional("DEBUG")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit[<System.Diagnostics.Conditional("DEBUG")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unitPublic 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 eseguita un'azione per impostare il valore dell'indice e quindi viene chiamato Assert per verificare che il valore di indice sia valido. Se non è valido, Assert restituisce lo stack di chiamate.
// Create an index for an array.
int index;
// Perform some action that sets the index.
index = -40;
// Test that the index value is valid.
Debug.Assert(index > -1);
' Create an index for an array.
Dim index As Integer
' Perform some action that sets the index.
index = -40
' Test that the index value is valid.
Debug.Assert((index > - 1))
Commenti
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. 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 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
Le app di Windows 8.x non supportano finestre di dialogo modali, quindi si comportano allo stesso modo in modalità interfaccia utente e in modalità non utente. Il messaggio viene scritto nei listener di traccia attivi in modalità di debug oppure non viene scritto alcun messaggio in modalità di rilascio.
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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
Vedi anche
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Si applica a
Assert(Boolean, Debug+AssertInterpolatedStringHandler)
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.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::Diagnostics::Debug::AssertInterpolatedStringHandler % message);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler -> unitPublic Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)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.
Messaggio da inviare alla Listeners raccolta.
- Attributi
Commenti
Questo overload è stato introdotto in .NET 6 per migliorare le prestazioni. Rispetto agli overload che accettano un String parametro, questo overload valuta solo gli elementi di formattazione di stringa interpolati se il messaggio è necessario.
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Per altre informazioni, vedere Asserzioni nel Codice Gestito.
In genere, il Assert 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 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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
Vedi anche
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Si applica a
Assert(Boolean, String)
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.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("DEBUG")]
public static void Assert(bool condition, string message);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string? message = default);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string? message);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string -> unitPublic Shared Sub Assert (condition As Boolean, message As String)Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)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.
- Attributi
Esempio
Nell'esempio seguente viene verificato se il type parametro è valido. Se type è null, Assert restituisce un messaggio.
public static void MyMethod(Type type, Type baseType)
{
Debug.Assert(type != null, "Type parameter is null");
// Perform some processing.
}
Public Shared Sub MyMethod(type As Type, baseType As Type)
Debug.Assert(Not (type Is Nothing), "Type parameter is null")
End Sub
Commenti
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Per altre informazioni, vedere Asserzioni nel Codice Gestito.
In genere, il Assert 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 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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
Vedi anche
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Si applica a
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.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::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler * AssertInterpolatedStringHandler -> unitPublic Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)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.
Messaggio da inviare alla Listeners raccolta.
- detailMessage
- Debug.AssertInterpolatedStringHandler
Messaggio dettagliato da inviare alla Listeners raccolta.
- Attributi
Commenti
Questo overload è stato introdotto in .NET 6 per migliorare le prestazioni. Rispetto agli overload che accettano un String parametro, questo overload valuta solo gli elementi di formattazione di stringa interpolati se il messaggio è necessario.
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Per altre informazioni, vedere Asserzioni nel Codice Gestito.
In genere, il Assert 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 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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
Vedi anche
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Si applica a
Assert(Boolean, String, String)
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.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("DEBUG")]
public static void Assert(bool condition, string message, string detailMessage);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string? message, string? detailMessage);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string -> unitPublic 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.
- Attributi
Esempio
Nell'esempio seguente viene verificato se il type parametro è valido. Se type è null, Assert restituisce due messaggi.
public static void MyMethod(Type type, Type baseType)
{
Debug.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)
Debug.Assert( Not (type Is Nothing), "Type parameter is null", "Can't get object for null type")
' Perform some processing.
End Sub
Commenti
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. 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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
Vedi anche
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Si applica a
Assert(Boolean, String, String, Object[])
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
- Origine:
- Debug.cs
Verifica la presenza di una condizione; se la condizione è false, restituisce due messaggi (semplici e formattati) e visualizza una finestra di messaggio che mostra lo stack di chiamate.
public:
static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string message, string detailMessageFormat, params object[] args);[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string? message, string detailMessageFormat, params object?[] args);[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string * obj[] -> unitPublic Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())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.
- detailMessageFormat
- String
Stringa di formato composito da inviare alla Listeners raccolta. Questo messaggio contiene testo mescolato con zero o più elementi di formato, che corrispondono agli oggetti nella args matrice.
- args
- Object[]
Matrice di oggetti contenente zero o più oggetti da formattare.
- Attributi
Commenti
Questo metodo usa la funzionalità di formattazione composita .NET per convertire il valore di un oggetto nella relativa rappresentazione di testo e incorporare tale rappresentazione in una stringa. La stringa risultante viene inviata alla Listeners raccolta.
Per impostazione predefinita, il Debug.Assert metodo funziona solo nelle compilazioni di debug. Usare il Trace.Assert metodo se si desidera eseguire asserzioni nelle build di versione. Per altre informazioni, vedere Asserzioni nel Codice Gestito.
In genere, il Assert(Boolean, String, String, Object[]) metodo viene usato per identificare gli errori logici durante lo sviluppo del programma.
Assert valuta la condizione. Se il risultato è false, viene chiamato il String.Format(String, Object[]) metodo e la stringa e args la detailMessageFormat matrice vengono passati come parametri.
Assert(Boolean, String, String, Object[]) invia quindi il messaggio di testo specificato e il messaggio di testo formattato 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>
<assert assertuienabled="true" logfilename="c:\\myFile.log" />
</system.diagnostics>
</configuration>
