Debug.Assert Méthode

Définition

Vérifie une condition ; si la condition est false, affiche des messages et une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Surcharges

Assert(Boolean)

Vérifie une condition ; si la condition est false, affiche une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

Vérifie une condition ; si la condition a la valeur false, affiche un message spécifié et une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String)

Vérifie une condition ; si la condition est false, affiche deux messages spécifiés et une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

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

Vérifie une condition ; si la condition est false, affiche deux messages (simples et mis en forme) et une boîte de message qui mentionne la pile des appels.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

Assert(Boolean)

Vérifie une condition ; si la condition est false, affiche une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

public:
 static void Assert(bool condition);
public static void Assert (bool condition);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition);
static member Assert : bool -> unit
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

Paramètres

condition
Boolean

Expression conditionnelle à évaluer.The conditional expression to evaluate. Si la condition est true, aucun message d’échec n’est envoyé et la boîte de message ne s’affiche pas.If the condition is true, a failure message is not sent and the message box is not displayed.

Attributs

Exemples

L’exemple suivant crée un index pour un tableau, effectue une action pour définir la valeur de l’index, puis appelle Assert pour confirmer que la valeur d’index est valide.The following example creates an index for an array, performs some action to set the value of the index, and then calls Assert to confirm that the index value is valid. S’il n’est pas valide, Assert génère la pile des appels.If it is not valid, Assert outputs the call stack.

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

Remarques

Par défaut, la Debug.Assert méthode fonctionne uniquement dans les versions Debug.By default, the Debug.Assert method works only in debug builds. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les versions release.Use the Trace.Assert method if you want to do assertions in release builds. Pour plus d’informations, consultez assertions dans du code managé.For more information, see Assertions in Managed Code.

Important

Les Assert méthodes ne sont pas disponibles pour les Windows StoreWindows Store applications.The Assert methods are not available for Windows StoreWindows Store apps.

En règle générale, la Assert(Boolean) méthode est utilisée pour identifier les erreurs de logique pendant le développement du programme.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert évalue la condition.Assert evaluates the condition. Si le résultat est false , il envoie un message d’échec à la Listeners collection.If the result is false, it sends a failure message to the Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant TraceListener ou en supprimant un à partir de la Listeners collection.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de message qui affiche la pile des appels avec les numéros de fichier et de ligne.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. La boîte de message contient trois boutons : abandonner, Réessayeret Ignorer.The message box contains three buttons: Abort, Retry, and Ignore. Cliquez sur le bouton abandonner pour mettre fin à l’application.Clicking the Abort button terminates the application. Le fait de cliquer sur Réessayer vous envoie le code dans le débogueur si votre application s’exécute dans un débogueur, ou propose d’ouvrir un débogueur si ce n’est pas le cas.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Cliquez sur Ignorer pour continuer avec l’instruction suivante dans le code.Clicking Ignore continues with the next instruction in the code.

Notes

Windows 8.x StoreWindows 8.x Store les applications ne prennent pas en charge les boîtes de dialogue modales, donc elles se comportent de la même façon en mode interface utilisateur et en mode interface non-utilisateur.apps do not support modal dialog boxes, so they behave the same in user interface mode and non-user interface mode. Le message est écrit dans les écouteurs de la trace actifs en mode débogage, ou aucun message n’est écrit en mode release.The message is written to the active trace listeners in debugging mode, or no message is written in release mode.

Notes

L’affichage de la boîte de message dépend de la présence de DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. Si le DefaultTraceListener ne figure pas dans la Listeners collection, la boîte de message ne s’affiche pas.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerPeut être supprimé par l' < effacement > , par la < > suppressionou par l’appel de la Clear méthode sur la Listeners propriété ( System.Diagnostics.Trace.Listeners.Clear() ).The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Vous pouvez modifier le comportement du DefaultTraceListener dans le fichier de configuration qui correspond au nom de votre application.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Dans ce fichier, vous pouvez activer et désactiver la boîte de message Assert ou définir la DefaultTraceListener.LogFileName propriété.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Le fichier de configuration doit être mis en forme comme suit :The configuration file should be formatted as follows:

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

Voir aussi

S’applique à

Produit Introduit

Assert(Boolean, String)

Vérifie une condition ; si la condition a la valeur false, affiche un message spécifié et une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message);
public static void Assert (bool condition, string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message);
static member Assert : bool * string -> unit
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

Paramètres

condition
Boolean

Expression conditionnelle à évaluer.The conditional expression to evaluate. Si la condition a la valeur true, le message spécifié n’est pas envoyé et la boîte de message ne s’affiche pas.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String

Message à envoyer à la collection Listeners.The message to send to the Listeners collection.

Attributs

Exemples

L’exemple suivant vérifie si le type paramètre est valide.The following example checks whether the type parameter is valid. Si type est null , Assert génère un message.If type is null, Assert outputs a message.

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

Remarques

Par défaut, la Debug.Assert méthode fonctionne uniquement dans les versions Debug.By default, the Debug.Assert method works only in debug builds. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les versions release.Use the Trace.Assert method if you want to do assertions in release builds. Pour plus d’informations, consultez assertions dans du code managé.For more information, see Assertions in Managed Code.

En règle générale, la Assert méthode est utilisée pour identifier les erreurs de logique pendant le développement du programme.Typically, the Assert method is used to identify logic errors during program development. Assert évalue la condition.Assert evaluates the condition. Si le résultat est false , il envoie le message de diagnostic spécifié à la Listeners collection.If the result is false, it sends the specified diagnostic message to the Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant TraceListener ou en supprimant un à partir de la Listeners collection.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de message qui affiche la pile des appels avec les numéros de fichier et de ligne.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. La boîte de message contient trois boutons : abandonner, Réessayeret Ignorer.The message box contains three buttons: Abort, Retry, and Ignore. Cliquez sur le bouton abandonner pour mettre fin à l’application.Clicking the Abort button terminates the application. Le fait de cliquer sur Réessayer vous envoie le code dans le débogueur si votre application s’exécute dans un débogueur, ou propose d’ouvrir un débogueur si ce n’est pas le cas.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Cliquez sur Ignorer pour continuer avec l’instruction suivante dans le code.Clicking Ignore continues with the next instruction in the code.

Notes

L’affichage de la boîte de message dépend de la présence de DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. Si le DefaultTraceListener ne figure pas dans la Listeners collection, la boîte de message ne s’affiche pas.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerPeut être supprimé par l' < effacement > , par la < > suppressionou par l’appel de la Clear méthode sur la Listeners propriété ( System.Diagnostics.Trace.Listeners.Clear() ).The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Vous pouvez modifier le comportement du DefaultTraceListener dans le fichier de configuration qui correspond au nom de votre application.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Dans ce fichier, vous pouvez activer et désactiver la boîte de message Assert ou définir la DefaultTraceListener.LogFileName propriété.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Le fichier de configuration doit être mis en forme comme suit :The configuration file should be formatted as follows:

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

Voir aussi

S’applique à

Produit Introduit

Assert(Boolean, String, String)

Vérifie une condition ; si la condition est false, affiche deux messages spécifiés et une boîte de message qui montre la pile des appels.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);
public static void Assert (bool condition, string message, string detailMessage);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessage);
static member Assert : bool * string * string -> unit
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Paramètres

condition
Boolean

Expression conditionnelle à évaluer.The conditional expression to evaluate. Si la condition est true, les messages spécifiés ne sont pas envoyés et la boîte de message ne s’affiche pas.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

Message à envoyer à la collection Listeners.The message to send to the Listeners collection.

detailMessage
String

Message détaillé à envoyer à la collection Listeners.The detailed message to send to the Listeners collection.

Attributs

Exemples

L’exemple suivant vérifie si le type paramètre est valide.The following example checks whether the type parameter is valid. Si type est null , Assert génère deux messages.If type is null, Assert outputs two messages.

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

Remarques

Par défaut, la Debug.Assert méthode fonctionne uniquement dans les versions Debug.By default, the Debug.Assert method works only in debug builds. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les versions release.Use the Trace.Assert method if you want to do assertions in release builds. Pour plus d’informations, consultez assertions dans du code managé.For more information, see Assertions in Managed Code.

En règle générale, la Assert(Boolean, String, String) méthode est utilisée pour identifier les erreurs de logique pendant le développement du programme.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assert évalue la condition.Assert evaluates the condition. Si le résultat est false , il envoie le message de diagnostic et le message détaillé spécifiés à la Listeners collection.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant TraceListener ou en supprimant un à partir de la Listeners collection.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de message qui affiche la pile des appels avec les numéros de fichier et de ligne.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. La boîte de message contient trois boutons : abandonner, Réessayeret Ignorer.The message box contains three buttons: Abort, Retry, and Ignore. Cliquez sur le bouton abandonner pour mettre fin à l’application.Clicking the Abort button terminates the application. Le fait de cliquer sur Réessayer vous envoie le code dans le débogueur si votre application s’exécute dans un débogueur, ou propose d’ouvrir un débogueur si ce n’est pas le cas.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Cliquez sur Ignorer pour continuer avec l’instruction suivante dans le code.Clicking Ignore continues with the next instruction in the code.

Notes

L’affichage de la boîte de message dépend de la présence de DefaultTraceListener .The display of the message box depends on the presence of the DefaultTraceListener. Si le DefaultTraceListener ne figure pas dans la Listeners collection, la boîte de message ne s’affiche pas.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerPeut être supprimé par l' < effacement > , par la < > suppressionou par l’appel de la Clear méthode sur la Listeners propriété ( System.Diagnostics.Trace.Listeners.Clear() ).The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Vous pouvez modifier le comportement du DefaultTraceListener dans le fichier de configuration qui correspond au nom de votre application.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Dans ce fichier, vous pouvez activer et désactiver la boîte de message Assert ou définir la DefaultTraceListener.LogFileName propriété.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Le fichier de configuration doit être mis en forme comme suit :The configuration file should be formatted as follows:

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

Voir aussi

S’applique à

Produit Introduit

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

Vérifie une condition ; si la condition est false, affiche deux messages (simples et mis en forme) et une boîte de message qui mentionne la pile des appels.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);
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")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);
static member Assert : bool * string * string * obj[] -> unit
[<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())

Paramètres

condition
Boolean

Expression conditionnelle à évaluer.The conditional expression to evaluate. Si la condition est true, les messages spécifiés ne sont pas envoyés et la boîte de message ne s’affiche pas.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

Message à envoyer à la collection Listeners.The message to send to the Listeners collection.

detailMessageFormat
String

Chaîne de format composite à envoyer à la collection Listeners.The composite format string to send to the Listeners collection. Ce message contient du texte avec aucun ou plusieurs éléments de mise en forme qui correspondent à des objets dans le tableau args.This message contains text intermixed with zero or more format items, which correspond to objects in the args array.

args
Object[]

Tableau d'objets contenant aucun ou plusieurs objets à mettre en forme.An object array that contains zero or more objects to format.

Attributs

Remarques

Cette méthode utilise la fonctionnalité de mise en forme composite .net pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne.This method uses the .NET composite formatting feature to convert the value of an object to its text representation and embed that representation in a string. La chaîne résultante est envoyée à la Listeners collection.The resulting string is sent to the Listeners collection.

Par défaut, la Debug.Assert méthode fonctionne uniquement dans les versions Debug.By default, the Debug.Assert method works only in debug builds. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les versions release.Use the Trace.Assert method if you want to do assertions in release builds. Pour plus d’informations, consultez assertions dans du code managé.For more information, see Assertions in Managed Code.

En règle générale, la Assert(Boolean, String, String, Object[]) méthode est utilisée pour identifier les erreurs de logique pendant le développement du programme.Typically, the Assert(Boolean, String, String, Object[]) method is used to identify logic errors during program development. Assert évalue la condition.Assert evaluates the condition. Si le résultat est false , la String.Format(String, Object[]) méthode est appelée et la detailMessageFormat chaîne et le args tableau sont passés comme paramètres.If the result is false, The String.Format(String, Object[]) method is called and the detailMessageFormat string and args array are passed in as parameters. Assert(Boolean, String, String, Object[]) envoie ensuite le message texte spécifié et le message texte mis en forme à la Listeners collection.Assert(Boolean, String, String, Object[]) then sends the specified text message and the formatted text message to the Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant TraceListener ou en supprimant un à partir de la Listeners collection.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de message qui affiche la pile des appels avec les numéros de fichier et de ligne.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. La boîte de message contient trois boutons : abandonner, Réessayeret Ignorer.The message box contains three buttons: Abort, Retry, and Ignore. Cliquez sur le bouton abandonner pour mettre fin à l’application.Clicking the Abort button terminates the application. Le fait de cliquer sur Réessayer vous envoie le code dans le débogueur si votre application s’exécute dans un débogueur, ou propose d’ouvrir un débogueur si ce n’est pas le cas.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Cliquez sur Ignorer pour continuer avec l’instruction suivante dans le code.Clicking Ignore continues with the next instruction in the code.

Notes

L’affichage de la boîte de message dépend de la présence de DefaultTraceListener .The display of the message box is dependent on the presence of the DefaultTraceListener. Si le DefaultTraceListener ne figure pas dans la Listeners collection, la boîte de message ne s’affiche pas.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerPeut être supprimé par l' < effacement > , par la < > suppressionou par l’appel de la Clear méthode sur la Listeners propriété ( System.Diagnostics.Trace.Listeners.Clear() ).The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Vous pouvez modifier le comportement du DefaultTraceListener dans le fichier de configuration qui correspond au nom de votre application.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. Dans ce fichier, vous pouvez activer et désactiver la boîte de message Assert ou définir la DefaultTraceListener.LogFileName propriété.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. Le fichier de configuration doit être mis en forme comme suit :The configuration file should be formatted as follows:

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

S’applique à

Produit Introduit