Debug.WriteLine メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Runtime.dll

デバッグについての情報を 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

カテゴリ名とメッセージを 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")>]
static member WriteLine : string * string -> unit

Public Shared Sub WriteLine (message As String, category As String)

パラメーター

message

String

書き込むメッセージ。

category

String

出力を編成するために使用するカテゴリ名。

属性

ConditionalAttribute

例

次の例では、 という名前の を TraceSwitch 作成します generalSwitch。 このスイッチは、コード サンプルの外部で設定されます。

スイッチが 以上に TraceLevelError 設定されている場合、最初のエラー メッセージが に出力されます Listeners。 コレクションにリスナーを追加する Listeners 方法については、 クラスを TraceListenerCollection 参照してください。

次に TraceLevel 、 が に Verbose設定されている場合、2 番目のエラー メッセージと、 を最初のメッセージと category 同じ行に出力します。 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[])

ソース:

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")>]
static member WriteLine : string * obj[] -> unit

Public Shared Sub WriteLine (format As String, ParamArray args As Object())

パラメーター

format

String

0 個以上の書式項目が混在したテキストを含む複合書式指定文字列。各書式項目は、args 配列内のオブジェクトに対応します。

args

Object[]

0 個以上の書式設定対象オブジェクトを含んだオブジェクト配列。

属性

ConditionalAttribute

注釈

このメソッドでは 、.NET 複合書式設定機能を 使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。

このメソッドの構文でキーワード (keyword)パラメーター (C#) または ParamArray (Visual Basic の場合) は、オブジェクト配列を 1 つの値にできることを意味します。 これに対する例外は オブジェクトです String 。 明示的なオーバーロードが優先されるため arg 、1 つの文字列の値は既定でオーバーロードになります Debug.WriteLine(String, String) 。

既定では、出力は の DefaultTraceListenerインスタンスに書き込まれます。

このメソッドは、 TraceListener.WriteLine トレース リスナーの メソッドを呼び出します。

WriteLine(String)

ソース:

Debug.cs

Listeners コレクションのトレース リスナーにメッセージを書き込み、続けて行終端記号を書き込みます。

public:
 static void WriteLine(System::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

書き込むメッセージ。

属性

ConditionalAttribute

例

次の例では、 という名前の を 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)

ソース:

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")>]
static member WriteLine : obj -> unit

Public Shared Sub WriteLine (value As Object)

パラメーター

value

Object

名前が Listeners に送信されるオブジェクト。

属性

ConditionalAttribute

例

次の例では、 という名前の を 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)

ソース:

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")>]
static member WriteLine : obj * string -> unit

Public Shared Sub WriteLine (value As Object, category As String)

パラメーター

value

Object

名前が Listeners に送信されるオブジェクト。

category

String

出力を編成するために使用するカテゴリ名。

属性

ConditionalAttribute

例

次の例では、 という名前の を 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