Trace.WriteLine メソッド

定義

トレースについての情報を Listeners コレクションのトレース リスナーに書き込みます。Writes information about the trace to the trace listeners in the Listeners collection.

オーバーロード

WriteLine(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。Writes a message to the trace listeners in the Listeners collection.

WriteLine(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and message to the trace listeners in the Listeners collection.

WriteLine(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

public:
 static void WriteLine(System::Object ^ value);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (object? value);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (object value);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLine : obj -> unit
Public Shared Sub WriteLine (value As Object)

パラメーター

value
Object

名前が Listeners に送信される ObjectAn Object whose name is sent to the Listeners.

属性

次の例では、という名前のを作成し TraceSwitch generalSwitch ます。The following example creates a TraceSwitch named generalSwitch. このスイッチは、コードサンプルの外部で設定されています。This switch is set outside the code sample.

スイッチが以上に設定されている場合、この例では TraceLevel Error 、最初のエラーメッセージをに出力し Listeners ます。If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. リスナーをコレクションに追加する方法の詳細につい Listeners ては、クラスを参照してください TraceListenerCollectionFor information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

次に、がに設定されている場合、この例では、 TraceLevel Verbose 最初のメッセージと同じ行にオブジェクトの名前が出力されます。Then, if the TraceLevel is set to Verbose, the example outputs the name of the object on the same line as the first message. 2番目のメッセージの後に行終端記号が続きます。The second message is followed by a line terminator.

// Class-level declaration.
// Create a TraceSwitch.
private:
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General", "Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject )
   {
      #if defined(TRACE)
      // Write the message if the TraceSwitch level 
      // is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::Write( "Invalid object. " );
      }
      
      // Write a second message if the TraceSwitch level
      // is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         Trace::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)
       Trace.Write("Invalid object. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.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
        Trace.Write("Invalid object. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine(myObject)
    End If
End Sub

注釈

既定では、出力はのインスタンスに書き込まれ DefaultTraceListener ます。By default, the output is written to an instance of DefaultTraceListener.

このメソッドは、 WriteLine トレースリスナーのメソッドを呼び出します。This method calls the WriteLine method of the trace listener.

こちらもご覧ください

適用対象

WriteLine(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。Writes a message to the trace listeners in the Listeners collection.

public:
 static void WriteLine(System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLine : string -> unit
Public Shared Sub WriteLine (message As String)

パラメーター

message
String

書き込むメッセージ。A message to write.

属性

次の例では、という名前のを作成し TraceSwitch generalSwitch ます。The following example creates a TraceSwitch named generalSwitch. このスイッチは、コードサンプルの外部で設定されています。This switch is set outside the code sample.

スイッチが以上に設定されている場合、この例では TraceLevel Error 、最初のエラーメッセージをに出力し Listeners ます。If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. リスナーをコレクションに追加する方法の詳細につい Listeners ては、クラスを参照してください TraceListenerCollectionFor information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

次に、がに設定されている場合、この例では、 TraceLevel Verbose 最初のメッセージと同じ行に2番目のエラーメッセージを出力します。Then, if the TraceLevel is set to Verbose, the example outputs the second error message on the same line as the first message. 2番目のメッセージの後に行終端記号が続きます。The second message is followed by a line terminator.

// Class-level declaration.
// Create a TraceSwitch.
private:
   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 )
      {
         Trace::Write( "My error message. " );
      }
      
      // Write a second message if the TraceSwitch level is set
      // to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
          Trace::WriteLine( "My second error message." );
      }
   }
// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod() {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch.TraceError)
       Trace.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.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
        Trace.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine("My second error message.")
    End If
End Sub

注釈

既定では、出力はのインスタンスに書き込まれ DefaultTraceListener ます。By default, the output is written to an instance of DefaultTraceListener.

このメソッドは、 WriteLine トレースリスナーのメソッドを呼び出します。This method calls the WriteLine method of the trace listener.

こちらもご覧ください

適用対象

WriteLine(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

public:
 static void WriteLine(System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (object? value, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (object value, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLine : obj * string -> unit
Public Shared Sub WriteLine (value As Object, category As String)

パラメーター

value
Object

名前が Listeners に送信される ObjectAn Object whose name is sent to the Listeners.

category
String

出力を編成するために使用するカテゴリ名。A category name used to organize the output.

属性

次の例では、という名前のを作成し TraceSwitch generalSwitch ます。The following example creates a TraceSwitch named generalSwitch. このスイッチは、コードサンプルの外部で設定されています。This switch is set outside the code sample.

スイッチが以上に設定されている場合、この例では TraceLevel Error 、最初のエラーメッセージをに出力し Listeners ます。If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. リスナーをコレクションに追加する方法の詳細につい Listeners ては、クラスを参照してください TraceListenerCollectionFor information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

次に、がに設定されている場合、この例では、 TraceLevel Verbose 最初のメッセージと同じ行に2番目のエラーメッセージを出力します。Then, if the TraceLevel is set to Verbose, the example outputs the second error message on the same line as the first message. 2番目のメッセージの後に行終端記号が続きます。The second message is followed by a line terminator.

// Class-level declaration.
// Create a TraceSwitch.
private:
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General", "Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject, String^ category )
   {
      #if defined(TRACE)
      // Write the message if the TraceSwitch level 
      // is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::Write( "Invalid object for category. " );
      }
      
      // Write a second message if the TraceSwitch level
      // is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         Trace::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)
       Trace.Write("Invalid object for category. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.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
        Trace.Write("Invalid object for category. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine(myObject, category)
    End If
End Sub

注釈

既定では、出力はのインスタンスに書き込まれ DefaultTraceListener ます。By default, the output is written to an instance of DefaultTraceListener.

パラメーターを使用して、 category 出力メッセージをグループ化できます。The category parameter can be used to group output messages.

このメソッドは、 WriteLine トレースリスナーのメソッドを呼び出します。This method calls the WriteLine method of the trace listener.

こちらもご覧ください

適用対象

WriteLine(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and message to the trace listeners in the Listeners collection.

public:
 static void WriteLine(System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (string? message, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLine (string message, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLine : string * string -> unit
Public Shared Sub WriteLine (message As String, category As String)

パラメーター

message
String

書き込むメッセージ。A message to write.

category
String

出力を編成するために使用するカテゴリ名。A category name used to organize the output.

属性

次の例では、という名前のを作成し TraceSwitch generalSwitch ます。The following example creates a TraceSwitch named generalSwitch. このスイッチは、コードサンプルの外部で設定されています。This switch is set outside the code sample.

スイッチが以上に設定されている場合、この例では TraceLevel Error 、最初のエラーメッセージをに出力し Listeners ます。If the switch is set to the TraceLevelError or higher, the example outputs the first error message to the Listeners. リスナーをコレクションに追加する方法の詳細につい Listeners ては、クラスを参照してください TraceListenerCollectionFor information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

次に、がに設定されている場合、 TraceLevel Verbose 2 番目のエラーメッセージとが category 最初のメッセージと同じ行に出力されます。Then, if the TraceLevel is set to Verbose, the example outputs the second error message and the category on the same line as the first message. 2番目のメッセージの後に行終端記号が続きます。The second message is followed by a line terminator.

// Class-level declaration.
// Create a TraceSwitch.
private:
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General", "Entire Application" );

public:
   static void MyErrorMethod( String^ category )
   {
      #if defined(TRACE)
      // Write the message if the TraceSwitch level 
      // is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::Write( "My error message. " );
      }
      
      // Write a second message if the TraceSwitch level
      // is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         Trace::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)
       Trace.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.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
        Trace.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine("My second error message.", category)
    End If
End Sub

注釈

既定では、出力はのインスタンスに書き込まれ DefaultTraceListener ます。By default, the output is written to an instance of DefaultTraceListener.

パラメーターを使用して、 category 出力メッセージをグループ化できます。The category parameter can be used to group output messages.

このメソッドは、 WriteLine トレースリスナーのメソッドを呼び出します。This method calls the WriteLine method of the trace listener.

こちらもご覧ください

適用対象