Debug.WriteLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает сведения об отладке в прослушиватели трассировки в коллекции Listeners.
Перегрузки
WriteLine(String, String) |
Записывает имя категории и сообщение в прослушиватели трассировки в коллекции Listeners. |
WriteLine(String, Object[]) |
Записывает форматированное сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners. |
WriteLine(String) |
Записывает сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции Listeners. |
WriteLine(Object) |
Записывает значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners. |
WriteLine(Object, String) |
Записывает имя категории и значение метода ToString() объекта в прослушиватели трассировки в коллекции Listeners. |
WriteLine(String, String)
Записывает имя категории и сообщение в прослушиватели трассировки в коллекции 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)
Параметры
- message
- String
Записываемое сообщение.
- category
- String
Имя категории, используемое для систематизации выходных данных.
- Атрибуты
Примеры
В следующем примере создается именованный TraceSwitch generalSwitch
объект . Этот параметр задается за пределами примера кода.
Если для параметра задано TraceLevel Error
значение или выше, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в коллекцию Listeners см. в TraceListenerCollection этом классе.
Затем, если TraceLevel задано значение Verbose
, в примере выводится второе сообщение об ошибке и в category
той же строке, что и первое сообщение. Признак конца строки следует второму сообщению.
// 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.
Параметр category
можно использовать для группировки выходных сообщений.
Этот метод вызывает WriteLine метод прослушивателя трассировки.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Применяется к
WriteLine(String, Object[])
Записывает форматированное сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции 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())
Параметры
- format
- String
Строка составного формата, содержащая текст, который перемежается несколькими элементами форматирования (или ни одним из них), соответствующими объектам в массиве args
.
- args
- Object[]
Массив объектов, содержащий нуль или более форматируемых объектов.
- Атрибуты
Комментарии
Этот метод использует функцию составного форматирования .NET для преобразования значения объекта в текстовое представление и внедрения этого представления в строку.
Ключевое слово params (в C#) или ParamArray (в Visual Basic) в синтаксисе этого метода подразумевает, что массив объектов может быть одним значением. Исключением из этого является String объект. Явные перегрузки имеют приоритет, поэтому arg
значение одной строки по умолчанию будет иметь значение перегрузки Debug.WriteLine(String, String) .
По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.
Этот метод вызывает TraceListener.WriteLine метод прослушивателя трассировки.
Применяется к
WriteLine(String)
Записывает сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции 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)
Параметры
- message
- String
Записываемое сообщение.
- Атрибуты
Примеры
В следующем примере создается именованный TraceSwitch generalSwitch
объект . Этот параметр задается за пределами примера кода.
Если для параметра задано TraceLevel Error
значение или выше, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в коллекцию Listeners см. в TraceListenerCollection этом классе.
Затем, если TraceLevel задано значение Verbose
, в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение. Признак конца строки следует второму сообщению.
// 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
Комментарии
По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.
Этот метод вызывает WriteLine метод прослушивателя трассировки.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Применяется к
WriteLine(Object)
Записывает значение метода ToString() объекта в прослушиватели трассировки в коллекции 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)
Параметры
- Атрибуты
Примеры
В следующем примере создается именованный TraceSwitch generalSwitch
объект . Этот параметр задается за пределами примера кода.
Если для параметра задано TraceLevel Error
значение или выше, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в коллекцию Listeners см. в TraceListenerCollection этом классе.
Затем, если TraceLevel задано значение Verbose
, в примере выводится имя объекта в той же строке, что и первое сообщение. Признак конца строки следует второму сообщению.
// 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.
Этот метод вызывает WriteLine метод прослушивателя трассировки.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Применяется к
WriteLine(Object, String)
Записывает имя категории и значение метода ToString() объекта в прослушиватели трассировки в коллекции 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)
Параметры
- category
- String
Имя категории, используемое для систематизации выходных данных.
- Атрибуты
Примеры
В следующем примере создается именованный TraceSwitch generalSwitch
объект . Этот параметр задается за пределами примера кода.
Если для параметра задано TraceLevel Error
значение или выше, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в коллекцию Listeners см. в TraceListenerCollection этом классе.
Затем, если TraceLevel задано значение Verbose
, в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение. За вторым сообщением следует признак конца строки.
// 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.
Параметр category
можно использовать для группировки выходных сообщений.
Этот метод вызывает WriteLine метод прослушивателя трассировки.
См. также раздел
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute