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)	カテゴリ名とオブジェクトの 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

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

属性: ConditionalAttribute

例

次の例では、名前付き 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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象

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 個以上の書式設定対象オブジェクトを含んだオブジェクト配列。

属性: ConditionalAttribute

注釈

このメソッドは、.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

書き込むメッセージ。

属性: ConditionalAttribute

例

次の例では、名前付き TraceSwitch generalSwitch. このスイッチは、コードサンプルの外部で設定されます。

次に、この 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)

オブジェクトの 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

例

次の例では、名前付き TraceSwitch generalSwitch. このスイッチは、コードサンプルの外部で設定されます。

次に、この 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)

カテゴリ名とオブジェクトの 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)

パラメーター

value: Object

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

category: String

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

属性: ConditionalAttribute

例

次の例では、名前付き TraceSwitch generalSwitch. このスイッチは、コードサンプルの外部で設定されます。

   // 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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象