Debug.Assert Méthode

Référence

Définition

Espace de noms:: System.Diagnostics

Assembly:: System.Diagnostics.Debug.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Vérifie une condition ; si la condition est false, affiche des messages et une boîte de message qui montre la pile des appels.

Surcharges

Assert(Boolean)	Vérifie une condition ; si la condition est `false`, affiche une boîte de message qui montre la pile des appels.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	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.
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.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	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.
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.
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.

Assert(Boolean)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Vérifie une condition ; si la condition est false, affiche une boîte de message qui montre la pile des appels.

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)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. Si la condition est true, aucun message d’échec n’est envoyé et la boîte de message ne s’affiche pas.

Attributs: ConditionalAttribute

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. S’il n’est pas valide, Assert génère la pile des appels.

// 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 méthode Debug.Assert fonctionne uniquement dans les builds de débogage. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les builds release. Pour plus d’informations, consultez Assertions dans du code managé.

En règle générale, la Assert(Boolean) méthode est utilisée pour identifier les erreurs logiques pendant le développement du programme. Assert évalue la condition. Si le résultat est false, il envoie un message d’échec à la Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant ou en supprimant un TraceListener de la Listeners collection.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de messages qui affiche la pile des appels avec des numéros de fichier et de ligne. La boîte de message contient trois boutons : Abandonner, Réessayer et Ignorer. Cliquer sur le bouton Abandonner met fin à l’application. Cliquer sur Réessayer vous envoie au code du 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. Le fait de cliquer sur Ignorer continue avec l’instruction suivante dans le code.

Notes

les applications Windows 8.x ne prennent pas en charge les boîtes de dialogue modales. Elles se comportent donc de la même façon en mode interface utilisateur et en mode non utilisateur. Le message est écrit dans les écouteurs de trace actifs en mode débogage, ou aucun message n’est écrit en mode release.

Notes

L’affichage de la boîte de message dépend de la présence du DefaultTraceListener. Si le DefaultTraceListener n’est pas dans la Listeners collection, la boîte de message ne s’affiche pas. Le DefaultTraceListener peut être supprimé en appelant la Clear méthode sur la Listeners propriété (System.Diagnostics.Trace.Listeners.Clear()). Pour les applications .NET Framework, vous pouvez également utiliser l’élément< clear> et l’élément remove> dans le< fichier de configuration de votre application.

Pour les applications .NET Framework, vous pouvez modifier le comportement de dans DefaultTraceListener le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez activer et désactiver la boîte de message d’assertion ou définir la DefaultTraceListener.LogFileName propriété . Le fichier de configuration doit être mis en forme comme suit :

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

Voir aussi

S’applique à

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

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)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. 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.

message: Debug.AssertInterpolatedStringHandler

Message à envoyer à la collection Listeners.

Attributs: ConditionalAttribute

Remarques

Cette surcharge a été introduite dans .NET 6 pour améliorer les performances. Par rapport aux surcharges qui acceptent un String paramètre, cette surcharge évalue uniquement les éléments de mise en forme de chaîne interpolée si le message est requis.

En règle générale, la Assert méthode est utilisée pour identifier les erreurs logiques pendant le développement du programme. Assert évalue la condition. Si le résultat est false, il envoie le message de diagnostic spécifié à la Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant ou en supprimant un TraceListener de la Listeners collection.

Notes

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

Voir aussi

S’applique à

Assert(Boolean, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

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)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. 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.

message: String

Message à envoyer à la collection Listeners.

Attributs: ConditionalAttribute

Exemples

L’exemple suivant vérifie si le type paramètre est valide. Si type a la valeur null, Assert génère un 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

Notes

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

Voir aussi

S’applique à

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

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

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)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. 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.

message: Debug.AssertInterpolatedStringHandler

Message à envoyer à la collection Listeners.

detailMessage: Debug.AssertInterpolatedStringHandler

Message détaillé à envoyer à la collection Listeners.

Attributs: ConditionalAttribute

Remarques

Cette surcharge a été introduite dans .NET 6 pour améliorer les performances. Par rapport aux surcharges qui prennent un String paramètre, cette surcharge évalue uniquement les éléments de mise en forme de chaîne interpolée si le message est requis.

Lorsque l’application s’exécute en mode interface utilisateur, elle affiche une boîte de message qui affiche la pile d’appels avec les numéros de fichier et de ligne. La zone de message contient trois boutons : Abandonner, Réessayer et Ignorer. Le fait de cliquer sur le bouton Abandonner met fin à l’application. Si vous cliquez sur Réessayer, vous accédez au code dans le débogueur si votre application s’exécute dans un débogueur, ou vous propose d’ouvrir un débogueur si ce n’est pas le cas. Cliquez sur Ignorer pour continuer avec l’instruction suivante dans le code.

Notes

L’affichage de la zone de message dépend de la présence du DefaultTraceListener. Si le DefaultTraceListener n’est pas dans la Listeners collection, la boîte de message ne s’affiche pas. DefaultTraceListener Le peut être supprimé en appelant la Clear méthode sur la Listeners propriété (System.Diagnostics.Trace.Listeners.Clear()). Pour les applications .NET Framework, vous pouvez également utiliser l’élément< clear> et l’élément remove> dans le< fichier de configuration de votre application.

Pour les applications .NET Framework, vous pouvez modifier le comportement de dans DefaultTraceListener le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez activer et désactiver la zone de message d’assertion ou définir la DefaultTraceListener.LogFileName propriété. Le fichier de configuration doit être mis en forme comme suit :

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

Voir aussi

S’applique à

Assert(Boolean, String, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

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)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. 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.

message: String

Message à envoyer à la collection Listeners.

detailMessage: String

Message détaillé à envoyer à la collection Listeners.

Attributs: ConditionalAttribute

Exemples

L’exemple suivant vérifie si le type paramètre est valide. Si type est null, Assert génère deux 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

En règle générale, la Assert(Boolean, String, String) méthode est utilisée pour identifier les erreurs logiques pendant le développement du programme. Assert évalue la condition. Si le résultat est false, il envoie le message de diagnostic et le message détaillé spécifiés à la Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant ou en supprimant un TraceListener à la Listeners collection.

Notes

Pour les applications .NET Framework, vous pouvez modifier le comportement de dans DefaultTraceListener le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez activer et désactiver la zone de message d’assertion ou définir la DefaultTraceListener.LogFileName propriété. Le fichier de configuration doit être mis en forme comme suit :

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

Voir aussi

S’applique à

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

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

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

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. 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.

message: String

Message à envoyer à la collection Listeners.

detailMessageFormat: String

Chaîne de format composite à envoyer à la collection Listeners. Ce message contient du texte avec aucun ou plusieurs éléments de mise en forme qui correspondent à des objets dans le tableau args.

args: Object[]

Tableau d'objets contenant aucun ou plusieurs objets à mettre en forme.

Attributs: ConditionalAttribute

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. La chaîne résultante est envoyée à la Listeners collection.

En règle générale, la Assert(Boolean, String, String, Object[]) méthode est utilisée pour identifier les erreurs logiques pendant le développement du programme. Assert évalue la condition. Si le résultat est false, la String.Format(String, Object[]) méthode est appelée et la chaîne et args le detailMessageFormat tableau sont passés en tant que paramètres. Assert(Boolean, String, String, Object[]) envoie ensuite le message texte spécifié et le message texte mis en forme à la Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant ou en supprimant un TraceListener à la Listeners collection.

Notes

L’affichage de la zone de message dépend de la présence de .DefaultTraceListener Si le DefaultTraceListener n’est pas dans la Listeners collection, la boîte de message ne s’affiche pas. DefaultTraceListener Le peut être supprimé en appelant la Clear méthode sur la Listeners propriété (System.Diagnostics.Trace.Listeners.Clear()). Pour les applications .NET Framework, vous pouvez également utiliser l’élément< clear> et l’élément remove> dans le< fichier de configuration de votre application.

Pour les applications .NET Framework, vous pouvez modifier le comportement de dans DefaultTraceListener le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez activer et désactiver la zone de message d’assertion ou définir la DefaultTraceListener.LogFileName propriété. Le fichier de configuration doit être mis en forme comme suit :

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

S’applique à

Debug.Assert Méthode

Définition

Surcharges

Assert(Boolean)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Paramètres

Remarques

Voir aussi

S’applique à

Assert(Boolean, String)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Remarques

Voir aussi

S’applique à

Assert(Boolean, String, String)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Remarques

S’applique à

Commentaires

Ressources supplémentaires