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)
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Записывает имя категории и сообщение в прослушиватели трассировки в коллекции 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
. Этот параметр задается за пределами примера кода.
Если параметр имеет значение TraceLevelError
или выше, в примере выводится первое сообщение об ошибке в 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[])
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Записывает форматированное сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции 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 для преобразования значения объекта в его текстовое представление и внедрения этого представления в строку.
Параметр (в C#) или ParamArray (в Visual Basic) ключевое слово в синтаксисе этого метода подразумевает, что массив объектов может быть одним значением. Исключением из этого является String объект . Явные перегрузки имеют приоритет, поэтому arg
значение одной строки по умолчанию будет иметь перегрузку Debug.WriteLine(String, String) .
По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.
Этот метод вызывает TraceListener.WriteLine метод прослушивателя трассировки.
Применяется к
WriteLine(String)
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Записывает сообщение, заканчивающееся ограничителем строки, в прослушиватели трассировки в коллекции 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
. Этот параметр задается за пределами примера кода.
Если параметр имеет значение TraceLevelError
или выше, в примере выводится первое сообщение об ошибке в 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)
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Записывает значение метода 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
. Этот параметр задается за пределами примера кода.
Если параметр имеет значение TraceLevelError
или выше, в примере выводится первое сообщение об ошибке в 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)
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
- Исходный код:
- Debug.cs
Записывает имя категории и значение метода 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
. Этот параметр задается за пределами примера кода.
Если параметр имеет значение TraceLevelError
или выше, в примере выводится первое сообщение об ошибке в 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
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по