Debug.WriteLine メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
デバッグについての情報を 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
. このスイッチは、コード サンプルの外部で設定されます。
スイッチが次の値以上にTraceLevelError
設定されている場合、最初のエラー メッセージが出力されますListeners。 リスナーをコレクションに追加する Listeners 方法については、クラスを TraceListenerCollection 参照してください。
次に、このTraceLevel例では、2 番目のエラー メッセージを出力し、最初のcategory
メッセージと同じ行に出力Verbose
します。 2 番目のメッセージの後に行ターミネータが続きます。
// 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
0 個以上の書式項目が混在したテキストを含む複合書式指定文字列。各書式項目は、args
配列内のオブジェクトに対応します。
- args
- Object[]
0 個以上の書式設定対象オブジェクトを含んだオブジェクト配列。
- 属性
注釈
このメソッドは 、.NET 複合書式設定機能を 使用してオブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。
このメソッドの構文のパラメーター (C#) または ParamArray (Visual Basic) キーワードは、オブジェクト配列が 1 つの値にできることを意味します。 これに対する例外はオブジェクトです String 。 明示的なオーバーロードが優先されるため arg
、1 つの文字列の値が既定で 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
. このスイッチは、コード サンプルの外部で設定されます。
スイッチが次の値以上にTraceLevelError
設定されている場合、最初のエラー メッセージが出力されますListeners。 リスナーをコレクションに追加する Listeners 方法については、クラスを TraceListenerCollection 参照してください。
次に、この TraceLevel 例が設定 Verbose
されている場合は、最初のメッセージと同じ行に 2 番目のエラー メッセージを出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// 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
. このスイッチは、コード サンプルの外部で設定されます。
スイッチが次の値以上にTraceLevelError
設定されている場合、最初のエラー メッセージが出力されますListeners。 リスナーをコレクションに追加する Listeners 方法については、クラスを TraceListenerCollection 参照してください。
次に、この TraceLevel 例を設定すると Verbose
、最初のメッセージと同じ行にオブジェクトの名前が出力されます。 2 番目のメッセージの後に行ターミネータが続きます。
// 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
. このスイッチは、コード サンプルの外部で設定されます。
スイッチが次の値以上にTraceLevelError
設定されている場合、最初のエラー メッセージが出力されますListeners。 リスナーをコレクションに追加する Listeners 方法については、クラスを TraceListenerCollection 参照してください。
次に、この TraceLevel 例が設定 Verbose
されている場合は、最初のメッセージと同じ行に 2 番目のエラー メッセージを出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// 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