Partager via


Trace.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.

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

Source:
Trace.cs
Source:
Trace.cs
Source:
Trace.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("TRACE")]
public static void Assert (bool condition);
[<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, aucun message d’échec n’est envoyé et la boîte de message ne s’affiche pas.

Attributs

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, le Assert génère la pile des appels.

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

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }
// 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 release. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. 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(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 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

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

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("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, 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

Exemples

L’exemple suivant vérifie que le type paramètre est valide. Si le type passé est null, génère Assert un message.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }
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 release. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. Pour plus d’informations, consultez Assertions dans du 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 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

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

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

Exemples

L’exemple suivant vérifie que le type paramètre est valide. Si le type passé est null, génère Assert un message.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }
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 release. La Debug.Assert méthode fonctionne uniquement dans les builds de débogage. Pour plus d’informations, consultez Assertions dans du 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 et le message détaillé spécifiés à 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

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