Trace.Write 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

將追蹤資訊寫入 Listeners 集合中的追蹤接聽項。

多載

Write(Object)	將物件的 ToString() 方法值寫入 Listeners 集合中的追蹤接聽項。
Write(String)	將訊息寫入 Listeners 集合中的追蹤接聽項。
Write(Object, String)	將物件之 ToString() 方法的分類名稱和值寫入 Listeners 集合中的追蹤接聽項。
Write(String, String)	將分類名稱和訊息寫入 Listeners 集合中的追蹤接聽項。

Write(Object)

來源:

Trace.cs

將物件的 ToString() 方法值寫入 Listeners 集合中的追蹤接聽項。

public:
 static void Write(System::Object ^ value);

[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value);

[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj -> unit

Public Shared Sub Write (value As Object)

參數

value

Object

Object，其名稱會傳送到 Listeners。

屬性

ConditionalAttribute

範例

下列範例會 TraceSwitch 建立名為 generalSwitch的 。 這個參數是在程式碼範例之外設定。

如果參數設定為 TraceLevelError 或更新版本，則範例會將 參數的名字 value 輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定 Verbose為 ，則範例會在與第一個訊息相同的行上輸出訊息。 第二則訊息後面接著行終止符。

// 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實例。

這個方法會 Write 呼叫追蹤接聽程式的方法。

注意

ASP.NET 提供針對網頁量身打造的追蹤功能。 若要在 ASP.NET 頁面中撰寫追蹤訊息，請使用 Page.Trace 屬性。

根據預設，在與 ASP.NET 網頁相關聯的程式代碼中，語句Trace.Write("...")是屬性方法的Page.Trace呼叫Write。 若要在網頁中使用 System.Diagnostics.Trace 類別，您必須包含 命名空間，例如 System.Diagnostics.Trace.Write("...")。

另請參閱

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(String)

來源:

Trace.cs

將訊息寫入 Listeners 集合中的追蹤接聽項。

public:
 static void Write(System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message);

[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string -> unit

Public Shared Sub Write (message As String)

參數

message

String

要寫入的訊息。

屬性

ConditionalAttribute

範例

下列範例會 TraceSwitch 建立名為 generalSwitch的 。 這個參數是在程式碼範例之外設定。

如果參數設定為 TraceLevelError 或更新版本，則範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定 Verbose為 ，則範例會在與第一個訊息相同的一行上輸出第二個錯誤訊息。 第二個訊息後面的行終止符。

// 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實例。

這個方法會 Write 呼叫追蹤接聽程式的方法。

注意

ASP.NET 提供針對網頁量身打造的追蹤功能。 若要在 ASP.NET 頁面中撰寫追蹤訊息，請使用 Page.Trace 屬性。

根據預設，在與 ASP.NET 網頁相關聯的程式代碼中，語句Trace.Write("...")是屬性方法的Page.Trace呼叫Write。 若要在網頁中使用 System.Diagnostics.Trace 類別，您必須包含 命名空間，例如 System.Diagnostics.Trace.Write("...")。

另請參閱

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(Object, String)

來源:

Trace.cs

將物件之 ToString() 方法的分類名稱和值寫入 Listeners 集合中的追蹤接聽項。

public:
 static void Write(System::Object ^ value, System::String ^ category);

[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value, string? category);

[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj * string -> unit

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

參數

value

Object

Object 名稱會傳送到 Listeners。

category

String

用來組織輸出的類別名稱。

屬性

ConditionalAttribute

範例

下列範例會 TraceSwitch 建立名為 generalSwitch的 。 這個參數是在程式碼範例之外設定。

如果 參數設定為 TraceLevelVerbose，則範例會將 的名稱 myObject 和 category 輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Error 或更新版本，則範例會在與第一個訊息相同的一行上輸出第二個錯誤訊息。 第二則訊息後面接著行終止符。

// 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實例。

參數 category 可用來將輸出訊息分組。

這個方法會 Write 呼叫追蹤接聽程式的方法。

注意

ASP.NET 提供針對網頁量身打造的追蹤功能。 若要在 ASP.NET 頁面中撰寫追蹤訊息，請使用 Page.Trace 屬性。

根據預設，在與 ASP.NET 網頁相關聯的程式代碼中，語句Trace.Write("...")是屬性方法的Page.Trace呼叫Write。 若要在網頁中使用 System.Diagnostics.Trace 類別，您必須包含 命名空間，例如 System.Diagnostics.Trace.Write("...")。

另請參閱

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(String, String)

來源:

Trace.cs

將分類名稱和訊息寫入 Listeners 集合中的追蹤接聽項。

public:
 static void Write(System::String ^ message, System::String ^ category);

[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message, string? category);

[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string * string -> unit

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

參數

message

String

要寫入的訊息。

category

String

用來組織輸出的類別名稱。

屬性

ConditionalAttribute

範例

下列範例會 TraceSwitch 建立名為 generalSwitch的 。 這個參數是在程式碼範例之外設定。

如果 參數設定為 TraceLevelVerbose，則範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Error 或更新版本，則範例會在與第一個訊息相同的一行上輸出第二個錯誤訊息。 第二則訊息後面接著行終止符。

// 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實例。

參數 category 可用來將輸出訊息分組。

這個方法會 Write 呼叫追蹤接聽程式的方法。

注意

ASP.NET 提供針對網頁量身打造的追蹤功能。 若要在 ASP.NET 頁面中撰寫追蹤訊息，請使用 Page.Trace 屬性。

根據預設，在與 ASP.NET 網頁相關聯的程式代碼中，語句Trace.Write("...")是屬性方法的Page.Trace呼叫Write。 若要在網頁中使用 System.Diagnostics.Trace 類別，您必須包含 命名空間，例如 System.Diagnostics.Trace.Write("...")。

另請參閱

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute