Partager via

Trace.Assert Méthode

Définition

Espace de noms:
System.Diagnostics
Assemblys:
netstandard.dll, System.Diagnostics.TraceSource.dll
Assembly:
System.Diagnostics.TraceSource.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.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("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition);
[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit
[<System.Diagnostics.Conditional("TRACE")>]
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. Ensuite, une action est effectuée qui définit la valeur de l’index. Ensuite, le code appelle Assert pour vérifier que la valeur d’index est valide. S’il n’est pas valide, la Assert pile des appels est générée.

// Create an index for an array.
int index;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}

' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Remarques

Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les builds de mise en production. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. 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(Boolean) é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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Voir aussi

S’applique à

Assert(Boolean, String)

Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.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("TRACE")]
public static void Assert(bool condition, string? message = default);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)
Public Shared Sub Assert (condition As Boolean, message As String)

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 que le type paramètre est valide. Si le type passage est null, le Assert message est généré.

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

Remarques

Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les builds de mise en production. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. Pour plus d’informations, consultez Assertions dans Le code managé.

En règle générale, la Assert(Boolean, String) méthode est utilisée pour identifier les erreurs logiques pendant le développement du programme. Assert(Boolean, String) é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.

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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Voir aussi

S’applique à

Assert(Boolean, String, String)

Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.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("TRACE")]
public static void Assert(bool condition, string? message, string? detailMessage);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message, string detailMessage);
[<System.Diagnostics.Conditional("TRACE")>]
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 que le type paramètre est valide. Si le type passage est null, le Assert message est généré.

public static void MyMethod(Type type, Type baseType)
{
    Trace.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)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

Remarques

Utilisez la Trace.Assert méthode si vous souhaitez effectuer des assertions dans les builds de mise en production. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. Pour plus d’informations, consultez Assertions dans Le code managé.

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.

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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Voir aussi

S’applique à