Trace.Write 方法

定義

命名空間:: System.Diagnostics

組件:: netstandard.dll, System.Diagnostics.TraceSource.dll

組件:: System.Diagnostics.TraceSource.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
Write(Object)	將物件 ToString() 方法的值寫入集合中的 Listeners 追蹤監聽器。
Write(String)	會寫訊息給集合中的 Listeners 追蹤監聽器。
Write(Object, String)	將類別名稱及物件 ToString() 方法值寫入集合中的 Listeners 追蹤監聽器。
Write(String, String)	會寫入類別名稱及訊息給集合中的 Listeners 追蹤監聽者。

Write(Object)

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: 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")]
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.
 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("...") 是對 Write 該屬性方法 Page.Trace 的呼叫。若要在網頁中使用該System.Diagnostics.Trace類別，您必須包含命名空間，例如。 System.Diagnostics.Trace.Write("...")

另請參閱

適用於

Write(String)

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

會寫訊息給集合中的 Listeners 追蹤監聽器。

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

[System.Diagnostics.Conditional("TRACE")]
public static void Write(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.
 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 屬性。

另請參閱

適用於

Write(Object, String)

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: 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")]
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.
 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 屬性。

另請參閱

適用於

Write(String, String)

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: Trace.cs

來源:: 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")]
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.
 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 屬性。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？

共用方式為

Trace.Write 方法

定義

多載

Write(Object)

參數

範例

備註

另請參閱

適用於

Write(String)

參數

範例

備註

另請參閱

適用於

Write(Object, String)

參數

範例

備註

另請參閱

適用於

Write(String, String)

參數

範例

備註

另請參閱

適用於

意見反應