Debug.Assert Méthode

Définition

Espace de noms:: System.Diagnostics

Assemblys:: System.dll, System.Diagnostics.Debug.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Diagnostics.Debug.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.

Recherche une condition ; si la condition est false, génère des messages et affiche une zone de message qui affiche la pile des appels.

Surcharges

Nom	Description
Assert(Boolean)	Recherche une condition ; si la condition est `false`, affiche une boîte de message qui affiche la pile des appels.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Recherche une condition ; si la condition est `false`, génère un message spécifié et affiche une zone de message qui affiche la pile des appels.
Assert(Boolean, String)	Recherche une condition ; si la condition est `false`, génère un message spécifié et affiche une zone de message qui affiche la pile des appels.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Recherche une condition ; si la condition est `false`, génère un message spécifié et affiche une zone de message qui affiche la pile des appels.
Assert(Boolean, String, String)	Recherche une condition ; si la condition est `false`, génère deux messages spécifiés et affiche une zone de message qui affiche la pile des appels.
Assert(Boolean, String, String, Object[])	Recherche une condition ; si la condition est `false`, génère deux messages (simples et mis en forme) et affiche une zone de message qui affiche la pile des appels.

Assert(Boolean)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, affiche une boîte de message qui affiche la pile des appels.

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 -> unit

Public Shared Sub Assert (condition As Boolean)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. Si la condition est true, un message d’échec n’est pas envoyé et la zone de message n’est pas affichée.

Attributs: ConditionalAttribute OverloadResolutionPriorityAttribute

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

// 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 builds de débogage. Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les builds de mise en production. Pour plus d’informations, consultez Assertions dans Le 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 TraceListener en supprimant un de la 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 des numéros de fichier et de ligne. La zone de message contient trois boutons : Abandonner, Réessayer et Ignorer. Cliquer sur le bouton Abandonner met fin à l’application. En cliquant sur Nouvelle tentative, vous envoyez 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. Cliquer sur Ignorer continue avec l’instruction suivante dans le code.

Note

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

Note

L’affichage de la boîte de message dépend de la présence du DefaultTraceListener. Si ce DefaultTraceListener n’est pas dans la Listeners collection, la boîte de message n’est pas affichée. Vous DefaultTraceListener pouvez le supprimer 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< clair> et l’élément remove> dans le< fichier de configuration de votre application.

Pour les applications .NET Framework, vous pouvez modifier le comportement du fichier de DefaultTraceListener configuration correspondant au nom de votre application. Dans ce fichier, vous pouvez activer et désactiver la zone de message assert 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

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, génère un message spécifié et affiche une zone de message qui affiche 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 est true, le message spécifié n’est pas envoyé et la zone de message n’est pas affichée.

message: Debug.AssertInterpolatedStringHandler

Message à envoyer à la Listeners collection.

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és 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 TraceListener en supprimant un de la Listeners collection.

Note

<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

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, génère un message spécifié et affiche une zone de message qui affiche 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 = default);

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

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

Paramètres

condition: Boolean

Expression conditionnelle à évaluer. Si la condition est true, le message spécifié n’est pas envoyé et la zone de message n’est pas affichée.

message: String

Message à envoyer à la Listeners collection.

Attributs: ConditionalAttribute

Exemples

L’exemple suivant vérifie si le type paramètre est valide. Si type c’est nullle cas, Assert génère un message.

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

Note

<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

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, génère un message spécifié et affiche une zone de message qui affiche 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 est true, le message spécifié n’est pas envoyé et la zone de message n’est pas affichée.

message: Debug.AssertInterpolatedStringHandler

Message à envoyer à la Listeners collection.

detailMessage: Debug.AssertInterpolatedStringHandler

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

Attributs: ConditionalAttribute

Remarques

Note

<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

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, génère deux messages spécifiés et affiche une zone de message qui affiche 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 zone de message n’est pas affichée.

message: String

Message à envoyer à la Listeners collection.

detailMessage: String

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

Attributs: ConditionalAttribute

Exemples

L’exemple suivant vérifie si le type paramètre est valide. Si type c’est nullle cas, Assert génère deux messages.

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 spécifié et le message détaillé à la Listeners collection. Vous pouvez personnaliser ce comportement en ajoutant ou TraceListener en supprimant un de la Listeners collection.

Note

<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

Source:: Debug.cs

Source:: Debug.cs

Recherche une condition ; si la condition est false, génère deux messages (simples et mis en forme) et affiche une zone de message qui affiche 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 zone de message n’est pas affichée.

message: String

Message à envoyer à la Listeners collection.

detailMessageFormat: String

Chaîne de format composite à envoyer à la Listeners collection. Ce message contient du texte mélangé avec zéro ou plusieurs éléments de format, qui correspondent aux objets du args tableau.

args: Object[]

Tableau d’objets qui contient zéro 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 TraceListener en supprimant un de la Listeners collection.

Note

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

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