Debug.Assert Méthode

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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.

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

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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

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

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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.

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 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 à la Listeners collection.

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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

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

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Source:

Debug.cs

Source:

Debug.cs

Source:

Debug.cs

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

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.

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

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.

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>