Condividi tramite


Debug.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, Debug+AssertInterpolatedStringHandler)

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)

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

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

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, String, String, Object[])

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

Assert(Boolean)

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.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("DEBUG")]
public static void Assert (bool condition);
[<System.Diagnostics.Conditional("DEBUG")>]
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 eseguita un'azione per impostare il valore dell'indice e quindi viene chiamato Assert per confermare che il valore dell'indice è valido. Se non è valido, Assert restituisce lo stack di chiamate.

// Create a local value.
int index;

// Perform some action that sets the local value.
index = -40;

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif
// 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 metodo Debug.Assert 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à di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i numeri di file e 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

Windows 8.x le app non supportano finestre di dialogo modali, quindi si comportano allo stesso modo in modalità interfaccia utente e in modalità interfaccia utente. Il messaggio viene scritto nei listener di traccia attivi in modalità di debug oppure non viene scritto alcun messaggio in modalità di rilascio.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.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::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 -> unit
Public 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.

message
Debug.AssertInterpolatedStringHandler

Messaggio da inviare alla raccolta di Listeners.

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 delle stringhe interpolati se il messaggio è obbligatorio.

Per impostazione predefinita, il metodo Debug.Assert 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à di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i numeri di file e 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

Assert(Boolean, String)

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.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("DEBUG")]
public static void Assert (bool condition, string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message);
[<System.Diagnostics.Conditional("DEBUG")>]
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 se il type parametro è valido. Se type è null, Assert restituisce un messaggio.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}
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 metodo Debug.Assert 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à di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i numeri di file e 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.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::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 -> unit
Public 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.

message
Debug.AssertInterpolatedStringHandler

Messaggio da inviare alla raccolta di Listeners.

detailMessage
Debug.AssertInterpolatedStringHandler

Messaggio dettagliato da inviare alla raccolta di Listeners.

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 eventuali elementi di formattazione di stringhe interpolate se è necessario il messaggio.

Per impostazione predefinita, il metodo Debug.Assert 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 metodo viene usato per identificare gli errori della logica durante lo Assert 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 un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Quando l'applicazione viene eseguita in modalità di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

Assert(Boolean, String, String)

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.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("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 -> 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 se il type parametro è valido. Se type è null, Assert restituisce due messaggi.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}
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 metodo Debug.Assert 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 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à di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

Assert(Boolean, String, String, Object[])

Origine:
Debug.cs
Origine:
Debug.cs
Origine:
Debug.cs

Controlla una condizione. Se la condizione è false, vengono generati due messaggi (semplice e formattato) e viene visualizzata una finestra di messaggio contenente 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[] -> unit
Public 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.

message
String

Messaggio da inviare alla raccolta di Listeners.

detailMessageFormat
String

Stringa di formato composito da inviare alla raccolta Listeners. Questo messaggio contiene testo combinato con zero o più elementi di formato, che corrispondono a oggetti nella matrice args.

args
Object[]

Matrice di oggetti che contiene 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 metodo Debug.Assert 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 metodo viene usato per identificare gli errori della logica durante lo Assert(Boolean, String, String, Object[]) sviluppo del programma. Assert valuta la condizione. Se il risultato è false, Il String.Format(String, Object[]) metodo viene chiamato e la stringa e args la detailMessageFormat matrice vengono passate 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 un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Quando l'applicazione viene eseguita in modalità di interfaccia utente, viene visualizzata una finestra di messaggio che indica lo stack di chiamate con i 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Si applica a