Debug.WriteLine メソッド

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.Debug.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

デバッグに関する情報を、Listeners コレクション内のトレースリスナーに書き込みます。

オーバーロード

WriteLine(String, String)	カテゴリ名とメッセージを、Listeners コレクション内のトレースリスナーに書き込みます。
WriteLine(String, Object[])	書式設定されたメッセージの後に行終端記号を書き込み、Listeners コレクション内のトレースリスナーに書き込みます。
WriteLine(String)	メッセージの後に行終端記号を書き込み、Listeners コレクション内のトレースリスナーに書き込みます。
WriteLine(Object)	オブジェクトの ToString() メソッドの値を、Listeners コレクション内のトレースリスナーに書き込みます。
WriteLine(Object, String)	Listeners コレクション内のトレースリスナーに、カテゴリ名とオブジェクトの ToString() メソッドの値を書き込みます。

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

出力を整理するために使用されるカテゴリ名。

属性: ConditionalAttribute

例

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

スイッチが 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 メソッドを呼び出します。

こちらもご覧ください

適用対象

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

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

args: Object[]

書式設定する 0 個以上のオブジェクトを含むオブジェクト配列。

属性: ConditionalAttribute

注釈

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

このメソッドの構文のパラメーター (C#) または ParamArray は、オブジェクト配列を単一の値にできることを意味します。例外は、String オブジェクトです。明示的なオーバーロードが優先されるため、1 つの文字列の 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

書き込むメッセージ。

属性: ConditionalAttribute

例

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

次に、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 メソッドを呼び出します。

こちらもご覧ください

適用対象

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)

パラメーター

value: Object

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

属性: ConditionalAttribute

例

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

次に、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 メソッドを呼び出します。

こちらもご覧ください

適用対象

WriteLine(Object, String)

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

Listeners コレクション内のトレースリスナーに、カテゴリ名とオブジェクトの ToString() メソッドの値を書き込みます。

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)

パラメーター

value: Object

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

category: String

出力を整理するために使用されるカテゴリ名。

属性: ConditionalAttribute

例

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

   // 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.WriteLine メソッド

定義

オーバーロード

WriteLine(String, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

WriteLine(String, Object[])

パラメーター

注釈

適用対象

WriteLine(String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

WriteLine(Object)

パラメーター

例

注釈

こちらもご覧ください

適用対象

WriteLine(Object, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

その他のリソース