Partager via


Debug.WriteLine Méthode

Définition

Écrit des informations sur le débogage dans les écouteurs de trace dans la collection Listeners.

Surcharges

WriteLine(String, String)

Écrit un nom de catégorie et un message dans les écouteurs de trace dans la collection Listeners.

WriteLine(String, Object[])

Écrit un message mis en forme suivi d’un terminateur de ligne dans les écouteurs de trace dans la collection Listeners.

WriteLine(String)

Écrit un message suivi d’un terminateur de ligne dans les écouteurs de trace dans la collection Listeners.

WriteLine(Object)

Écrit la valeur de la méthode ToString() de l’objet dans les écouteurs de trace dans la collection Listeners.

WriteLine(Object, String)

Écrit un nom de catégorie et la valeur de la méthode ToString() de l’objet dans les écouteurs de trace de la collection Listeners.

WriteLine(String, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Écrit un nom de catégorie et un message dans les écouteurs de trace dans la collection Listeners.

public:
 static void WriteLine(System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string message, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string? message, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string * string -> unit
Public Shared Sub WriteLine (message As String, category As String)

Paramètres

message
String

Message à écrire.

category
String

Nom de catégorie utilisé pour organiser la sortie.

Attributs

Exemples

L’exemple suivant crée un TraceSwitch nommé generalSwitch. Ce commutateur est défini en dehors de l’exemple de code.

Si le commutateur est défini sur la TraceLevelError ou une version ultérieure, l’exemple génère le premier message d’erreur vers le Listeners. Pour plus d’informations sur l’ajout d’un écouteur à la collection Listeners, consultez la classe TraceListenerCollection.

Ensuite, si le TraceLevel est défini sur Verbose, l’exemple génère le deuxième message d’erreur et le category sur la même ligne que le premier message. Un terminateur de ligne suit le deuxième message.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         #if defined(DEBUG)
         Debug::Write( "My error message. " );
         #endif
      }
      // Write a second message if the TraceSwitch level is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         #if defined(DEBUG)
         Debug::WriteLine( "My second error message.", category );
         #endif
      }
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine("My second error message.", category);
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine("My second error message.", category)
    End If
End Sub

Remarques

Par défaut, la sortie est écrite dans une instance de DefaultTraceListener.

Le paramètre category peut être utilisé pour regrouper les messages de sortie.

Cette méthode appelle la méthode WriteLine de l’écouteur de trace.

Voir aussi

S’applique à

WriteLine(String, Object[])

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Écrit un message mis en forme suivi d’un terminateur de ligne dans les écouteurs de trace dans la collection Listeners.

public:
 static void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string format, params object[] args);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string format, params object?[] args);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string * obj[] -> unit
Public Shared Sub WriteLine (format As String, ParamArray args As Object())

Paramètres

format
String

Chaîne de format composite qui contient du texte mélangé avec zéro ou plusieurs éléments de format, qui correspondent aux objets du tableau args.

args
Object[]

Tableau d’objets qui contient zéro ou plusieurs objets à mettre en forme.

Attributs

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.

Les params (en C#) ou mot clé ParamArray (en Visual Basic) dans la syntaxe de cette méthode implique que le tableau d’objets peut être une valeur unique. L’exception à ceci est l’objet String. Les surcharges explicites sont prioritaires. Par conséquent, une valeur arg d’une chaîne unique est définie par défaut sur la surcharge Debug.WriteLine(String, String).

Par défaut, la sortie est écrite dans une instance de DefaultTraceListener.

Cette méthode appelle la méthode TraceListener.WriteLine de l’écouteur de trace.

S’applique à

WriteLine(String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Écrit un message suivi d’un terminateur de ligne dans les écouteurs de trace dans la collection Listeners.

public:
 static void WriteLine(System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (string? message);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string -> unit
Public Shared Sub WriteLine (message As String)

Paramètres

message
String

Message à écrire.

Attributs

Exemples

L’exemple suivant crée un TraceSwitch nommé generalSwitch. Ce commutateur est défini en dehors de l’exemple de code.

Si le commutateur est défini sur la TraceLevelError ou une version ultérieure, l’exemple génère le premier message d’erreur vers le Listeners. Pour plus d’informations sur l’ajout d’un écouteur à la collection Listeners, consultez la classe TraceListenerCollection.

Ensuite, si le TraceLevel est défini sur Verbose, l’exemple génère le deuxième message d’erreur sur la même ligne que le premier message. Un terminateur de ligne suit le deuxième message.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod()
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         #if defined(DEBUG)
         Debug::Write( "My error message. " );
         #endif
      }
      // Write a second message if the TraceSwitch level is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         #if defined(DEBUG)
         Debug::WriteLine( "My second error message." );
         #endif
      }
   }
// Class-level declaration.
// Create a TraceSwitch.
TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static void MyErrorMethod()
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine("My second error message.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine("My second error message.")
    End If
End Sub

Remarques

Par défaut, la sortie est écrite dans une instance de DefaultTraceListener.

Cette méthode appelle la méthode WriteLine de l’écouteur de trace.

Voir aussi

S’applique à

WriteLine(Object)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Écrit la valeur de la méthode ToString() de l’objet dans les écouteurs de trace dans la collection Listeners.

public:
 static void WriteLine(System::Object ^ value);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (object value);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (object? value);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : obj -> unit
Public Shared Sub WriteLine (value As Object)

Paramètres

value
Object

Objet dont le nom est envoyé au Listeners.

Attributs

Exemples

L’exemple suivant crée un TraceSwitch nommé generalSwitch. Ce commutateur est défini en dehors de l’exemple de code.

Si le commutateur est défini sur la TraceLevelError ou une version ultérieure, l’exemple génère le premier message d’erreur vers le Listeners. Pour plus d’informations sur l’ajout d’un écouteur à la collection Listeners, consultez la classe TraceListenerCollection.

Ensuite, si le TraceLevel est défini sur Verbose, l’exemple génère le nom de l’objet sur la même ligne que le premier message. Un terminateur de ligne suit le deuxième message.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         #if defined(DEBUG)
         Debug::Write( "Invalid object. " );
         #endif
      }
      // Write a second message if the TraceSwitch level is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         #if defined(DEBUG)
         Debug::WriteLine( myObject );
         #endif
      }
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("Invalid object. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine(myObject);
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("Invalid object. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine(myObject)
    End If
End Sub

Remarques

Par défaut, la sortie est écrite dans une instance de DefaultTraceListener.

Cette méthode appelle la méthode WriteLine de l’écouteur de trace.

Voir aussi

S’applique à

WriteLine(Object, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Écrit un nom de catégorie et la valeur de la méthode ToString() de l’objet dans les écouteurs de trace de la collection Listeners.

public:
 static void WriteLine(System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (object value, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine (object? value, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : obj * string -> unit
Public Shared Sub WriteLine (value As Object, category As String)

Paramètres

value
Object

Objet dont le nom est envoyé au Listeners.

category
String

Nom de catégorie utilisé pour organiser la sortie.

Attributs

Exemples

L’exemple suivant crée un TraceSwitch nommé generalSwitch. Ce commutateur est défini en dehors de l’exemple de code.

Si le commutateur est défini sur la TraceLevelError ou une version ultérieure, l’exemple génère le premier message d’erreur vers le Listeners. Pour plus d’informations sur l’ajout d’un écouteur à la collection Listeners, consultez la classe TraceListenerCollection.

Ensuite, si le TraceLevel est défini sur Verbose, l’exemple génère le deuxième message d’erreur sur la même ligne que le premier message. Le deuxième message est suivi d’un terminateur de ligne.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject, String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         #if defined(DEBUG)
         Debug::Write( "Invalid object for category. " );
         #endif
      }
      // Write a second message if the TraceSwitch level is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         #if defined(DEBUG)
         Debug::WriteLine( myObject, category );
         #endif
      }
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject, string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("Invalid object for category. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine(myObject, category);
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("Invalid object for category. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine(myObject, category)
    End If
End Sub

Remarques

Par défaut, la sortie est écrite dans une instance de DefaultTraceListener.

Le paramètre category peut être utilisé pour regrouper les messages de sortie.

Cette méthode appelle la méthode WriteLine de l’écouteur de trace.

Voir aussi

S’applique à