Debug.WriteLine Метод

Определение

Записывает сведения об отладке в прослушиватели трассировки в коллекции Listeners.Writes information about the debug to the trace listeners in the Listeners collection.

Перегрузки

WriteLine(Object)

Записывает значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String)

Записывает сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners.Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(Object, String)

Записывает имя категории и значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String, Object[])

Записывает форматированное сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners.Writes a formatted message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(String, String)

Записывает имя категории и сообщение в прослушиватели трассировки в коллекции Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLine(Object)

Записывает значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

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

Параметры

value
Object

Объект, имя которого отправляется в Listeners.An object whose name is sent to the Listeners.

Атрибуты

Примеры

В следующем примере создается TraceSwitch именованный generalSwitchобъект.The following example creates a TraceSwitch named generalSwitch. Этот параметр задается вне примера кода.This switch is set outside of the code sample.

Если параметр имеет значение TraceLevel Error или выше, в примере выводится Listenersпервое сообщение об ошибке в.If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. Дополнительные сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection разделе класс.For information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

Затем, если TraceLevel для Verboseзадано значение, в примере выводится имя объекта в той же строке, что и первое сообщение.Then, if the TraceLevel is set to Verbose, the example outputs the name of the object on the same line as the first message. Признак конца строки следует за вторым сообщением.A line terminator follows the second 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

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.By default, the output is written to an instance of DefaultTraceListener.

Этот метод вызывает WriteLine метод прослушивателя трассировки.This method calls the WriteLine method of the trace listener.

Дополнительно

WriteLine(String)

Записывает сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners.Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

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

Параметры

message
String

Записываемое сообщение.A message to write.

Атрибуты

Примеры

В следующем примере создается TraceSwitch именованный generalSwitchобъект.The following example creates a TraceSwitch named generalSwitch. Этот параметр задается вне примера кода.This switch is set outside of the code sample.

Если параметр имеет значение TraceLevel Error или выше, в примере выводится Listenersпервое сообщение об ошибке в.If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. Дополнительные сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection разделе класс.For information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

Затем, если TraceLevel для Verboseзадано значение, то в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение.Then, if the TraceLevel is set to Verbose, the example outputs the second error message on the same line as the first message. Признак конца строки следует за вторым сообщением.A line terminator follows the second 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.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
 
 static public 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

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.By default, the output is written to an instance of DefaultTraceListener.

Этот метод вызывает WriteLine метод прослушивателя трассировки.This method calls the WriteLine method of the trace listener.

Дополнительно

WriteLine(Object, String)

Записывает имя категории и значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

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

Параметры

value
Object

Объект, имя которого отправляется в Listeners.An object whose name is sent to the Listeners.

category
String

Имя категории, используемое для систематизации выходных данных.A category name used to organize the output.

Атрибуты

Примеры

В следующем примере создается TraceSwitch именованный generalSwitchобъект.The following example creates a TraceSwitch named generalSwitch. Этот параметр задается вне примера кода.This switch is set outside of the code sample.

Если параметр имеет значение TraceLevel Error или выше, в примере выводится Listenersпервое сообщение об ошибке в.If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. Дополнительные сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection разделе класс.For information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

Затем, если TraceLevel для Verboseзадано значение, то в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение.Then, if the TraceLevel is set to Verbose, the example outputs the second error message on the same line as the first message. За вторым сообщением следует признак конца строки.The second message is followed by a line terminator.

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

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.By default, the output is written to an instance of DefaultTraceListener.

category Параметр может использоваться для группирования выходных сообщений.The category parameter can be used to group output messages.

Этот метод вызывает WriteLine метод прослушивателя трассировки.This method calls the WriteLine method of the trace listener.

Дополнительно

WriteLine(String, Object[])

Записывает форматированное сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners.Writes a formatted message followed by a line terminator to the trace listeners in the Listeners collection.

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);
static member WriteLine : string * obj[] -> unit
Public Shared Sub WriteLine (format As String, ParamArray args As Object())

Параметры

format
String

Строка составного формата, содержащая текст, который перемежается несколькими элементами форматирования (или ни одним из них), соответствующими объектам в массиве args.A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the args array.

args
Object[]

Массив объектов, содержащий нуль или более форматируемых объектов.An object array that contains zero or more objects to format.

Атрибуты

Комментарии

Этот метод использует функцию составного форматирования .NET для преобразования значения объекта в текстовое представление и внедрения этого представления в строку.This method uses the .NET composite formatting feature to convert the value of an object to its text representation and embed that representation in a string.

Ключевое слово params C#(in) или ParamArray (in Visual Basic) в синтаксисе этого метода подразумевает, что массив объектов может иметь одно значение. The params (in C#) or ParamArray (in Visual Basic) keyword in the syntax for this method implies that the object array can be a single value. Исключением является String объект.The exception to this is the String object. Явные перегрузки имеют приоритет, поэтому arg значение одной строки будет по умолчанию Debug.WriteLine(String, String) перегружаться.Explicit overloads take precedence, so an arg value of a single string will default to the Debug.WriteLine(String, String) overload.

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.By default, the output is written to an instance of DefaultTraceListener.

Этот метод вызывает TraceListener.WriteLine метод прослушивателя трассировки.This method calls the TraceListener.WriteLine method of the trace listener.

WriteLine(String, String)

Записывает имя категории и сообщение в прослушиватели трассировки в коллекции Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

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

Параметры

message
String

Записываемое сообщение.A message to write.

category
String

Имя категории, используемое для систематизации выходных данных.A category name used to organize the output.

Атрибуты

Примеры

В следующем примере создается TraceSwitch именованный generalSwitchобъект.The following example creates a TraceSwitch named generalSwitch. Этот параметр задается вне примера кода.This switch is set outside of the code sample.

Если параметр имеет значение TraceLevel Error или выше, в примере выводится Listenersпервое сообщение об ошибке в.If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. Дополнительные сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection разделе класс.For information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

Затем, если TraceLevel для Verboseзадано значение, в примере выводится category второе сообщение об ошибке и в той же строке, что и первое сообщение.Then, if the TraceLevel is set to Verbose, the example outputs the second error message and the category on the same line as the first message. Признак конца строки следует за вторым сообщением.A line terminator follows the second 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

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.By default, the output is written to an instance of DefaultTraceListener.

category Параметр может использоваться для группирования выходных сообщений.The category parameter can be used to group output messages.

Этот метод вызывает WriteLine метод прослушивателя трассировки.This method calls the WriteLine method of the trace listener.

Дополнительно

Применяется к