Debug.Assert Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.Debug.dll

Assembly:: System.Runtime.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, 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)

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

Esempio

L'esempio seguente crea un indice per una matrice, esegue un'azione per impostare il valore dell'indice e quindi chiama Assert per verificare che il valore dell'indice sia valido. Se non è valida, 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 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 metodo viene usato per identificare gli errori della logica durante lo Assert(Boolean) sviluppo del programma. Assert 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à 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

le app Windows 8.x non supportano finestre di dialogo modali, quindi si comportano nello stesso modo nell'interfaccia utente e nella modalità interfaccia utente. Il messaggio viene scritto nei listener di traccia attivi in modalità di debug o nessun messaggio viene scritto in modalità di rilascio.

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

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

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.

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.

Nota

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

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

Nota

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

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.

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

Commenti

Nota

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

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

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.

Nota

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Vedi anche

Si applica a

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.

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

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.

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.

Nota

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Si applica a

Debug.Assert Metodo

Definizione

Overload

Assert(Boolean)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parametri

Commenti

Vedi anche

Si applica a

Assert(Boolean, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Commenti

Vedi anche

Si applica a

Assert(Boolean, String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Commenti

Si applica a

Commenti e suggerimenti

Risorse aggiuntive