Trace.Write Trace.Write Trace.Write Trace.Write Method

定義

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

オーバーロード

Write(Object) Write(Object) Write(Object) Write(Object)

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

Write(String) Write(String) Write(String) Write(String)

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

Write(Object, String) Write(Object, String) Write(Object, String) Write(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.

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

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

Write(Object) Write(Object) Write(Object) Write(Object)

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

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

パラメーター

value
Object Object Object Object

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

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

TraceLevelスイッチがError以降に設定されている場合、この例ではvalueパラメーター Listenersの名をに出力します。If the switch is set to the TraceLevelError or higher, the example outputs the first name of the value parameter to the Listeners. リスナーをListenersコレクションに追加する方法の詳細についTraceListenerCollectionては、クラスを参照してください。For 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 a 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 )
   {
      #if defined(TRACE)
      // Write the message if the TraceSwitch level 
      // is set to Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::Write( myObject );
      }
      
      // Write a second message if the TraceSwitch level
      // is set to Verbose.
      if ( generalSwitch->TraceVerbose )
      {
          Trace::WriteLine( " is not a valid value for this method." );
      }
      #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(myObject);
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.WriteLine(" is not a valid value for this method.");
 }

' 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(myObject)
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine(" is not a valid value for this method.")
    End If
End Sub

注釈

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

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

注意

ASP.NET は、Web ページ用に調整したトレース機能を提供します。ASP.NET supplies tracing functionality tailored for Web pages. ASP.NET ページにトレースメッセージを書き込むには、 Page.Traceプロパティを使用します。To write trace messages in ASP.NET pages, use the Page.Trace property.

既定では、ASP.NET Web ページに関連付けられているTrace.Write("...")コードでは、ステートメントWriteは、 Page.Traceプロパティのメソッドの呼び出しです。By default, in code associated with an ASP.NET Web page, the statement Trace.Write("...") is a call to the Write method of the Page.Trace property. Web ページでSystem.Diagnostics.Traceクラスを使用するには、などのSystem.Diagnostics.Trace.Write("...")名前空間を含める必要があります。To use the System.Diagnostics.Trace class in Web pages, you must include the namespace, for example, System.Diagnostics.Trace.Write("...").

こちらもご覧ください

Write(String) Write(String) Write(String) Write(String)

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

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

パラメーター

message
String String String String

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

次の例ではTraceSwitchgeneralSwitchという名前のを作成します。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コレクションに追加する方法の詳細についTraceListenerCollectionては、クラスを参照してください。For 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番目のメッセージの後に続きます。A line terminator follows the second message.

// 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.

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

注意

ASP.NET は、Web ページ用に調整したトレース機能を提供します。ASP.NET supplies tracing functionality tailored for Web pages. ASP.NET ページにトレースメッセージを書き込むには、 Page.Traceプロパティを使用します。To write trace messages in ASP.NET pages, use the Page.Trace property.

既定では、ASP.NET Web ページに関連付けられているTrace.Write("...")コードでは、ステートメントWriteは、 Page.Traceプロパティのメソッドの呼び出しです。By default, in code associated with an ASP.NET Web page, the statement Trace.Write("...") is a call to the Write method of the Page.Trace property. Web ページでSystem.Diagnostics.Traceクラスを使用するには、などのSystem.Diagnostics.Trace.Write("...")名前空間を含める必要があります。To use the System.Diagnostics.Trace class in Web pages, you must include the namespace, for example, System.Diagnostics.Trace.Write("...").

こちらもご覧ください

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

パラメーター

value
Object Object Object Object

Object の名前は Listeners に送信されます。An Object name is sent to the Listeners.

category
String String String String

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

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

TraceLevelスイッチがにListeners category myObject設定されている場合、この例では、およびの名前がに出力されます。 VerboseIf the switch is set to the TraceLevelVerbose, the example outputs the name of the myObject and the category to the Listeners. リスナーをListenersコレクションに追加する方法の詳細についTraceListenerCollectionては、クラスを参照してください。For information on adding a listener to the Listeners collection, see the TraceListenerCollection class.

次に、 TraceLevelが以上にError設定されている場合、この例では、最初のメッセージと同じ行に2番目のエラーメッセージを出力します。Then, if the TraceLevel is set to Error or higher, 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 Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         Trace::Write( myObject, category );
      }
      
      // Write a second message if the TraceSwitch level is set to 
      // Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::WriteLine( " Object is not valid for this 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 Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.Write(myObject, category);
 
    // Write a second message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch.TraceError)
       Trace.WriteLine(" Object is not valid for this 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 Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.Write(myObject, category)
    End If 
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Trace.WriteLine(" Object is not valid for this 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.

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

注意

ASP.NET は、Web ページ用に調整したトレース機能を提供します。ASP.NET supplies tracing functionality tailored for Web pages. ASP.NET ページにトレースメッセージを書き込むには、 Page.Traceプロパティを使用します。To write trace messages in ASP.NET pages, use the Page.Trace property.

既定では、ASP.NET Web ページに関連付けられているTrace.Write("...")コードでは、ステートメントWriteは、 Page.Traceプロパティのメソッドの呼び出しです。By default, in code associated with an ASP.NET Web page, the statement Trace.Write("...") is a call to the Write method of the Page.Trace property. Web ページでSystem.Diagnostics.Traceクラスを使用するには、などのSystem.Diagnostics.Trace.Write("...")名前空間を含める必要があります。To use the System.Diagnostics.Trace class in Web pages, you must include the namespace, for example, System.Diagnostics.Trace.Write("...").

こちらもご覧ください

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

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

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

パラメーター

message
String String String String

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

category
String String String String

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

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

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

次に、 TraceLevelが以上にError設定されている場合、この例では、最初のメッセージと同じ行に2番目のエラーメッセージを出力します。Then, if the TraceLevel is set to Error or higher, 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 Verbose.
      if ( generalSwitch->TraceVerbose )
      {
         Trace::Write( String::Concat( myObject, 
            " is not a valid object for category: " ), category );
      }
      
      // Write a second message if the TraceSwitch level is set to
      // Error or higher.
      if ( generalSwitch->TraceError )
      {
         Trace::WriteLine( " Please use a different 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 Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.Write(myObject.ToString() + " is not a valid object for category: ", 
          category);
 
    // Write a second message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch.TraceError)
       Trace.WriteLine(" Please use a different 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 Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.Write(myObject.ToString() & _
            " is not a valid object for category: ", category)
    End If
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Trace.WriteLine(" Please use a different 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.

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

注意

ASP.NET は、Web ページ用に調整したトレース機能を提供します。ASP.NET supplies tracing functionality tailored for Web pages. ASP.NET ページにトレースメッセージを書き込むには、 Page.Traceプロパティを使用します。To write trace messages in ASP.NET pages, use the Page.Trace property.

既定では、ASP.NET Web ページに関連付けられているTrace.Write("...")コードでは、ステートメントWriteは、 Page.Traceプロパティのメソッドの呼び出しです。By default, in code associated with an ASP.NET Web page, the statement Trace.Write("...") is a call to the Write method of the Page.Trace property. Web ページでSystem.Diagnostics.Traceクラスを使用するには、などのSystem.Diagnostics.Trace.Write("...")名前空間を含める必要があります。To use the System.Diagnostics.Trace class in Web pages, you must include the namespace, for example, System.Diagnostics.Trace.Write("...").

こちらもご覧ください

適用対象