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

範例

下列範例會建立名為 TraceSwitchgeneralSwitch。此參數是在程式代碼范例外部設定。

若開關設定為或 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 方法。

Note

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

範例

下列範例會建立名為 TraceSwitchgeneralSwitch。此參數是在程式代碼范例外部設定。

如果參數設定為 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 方法。

Note

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

範例

下列範例會建立名為 TraceSwitchgeneralSwitch。此參數是在程式代碼范例外部設定。

若開關設為 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 方法。

Note

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

範例

下列範例會建立名為 TraceSwitchgeneralSwitch。此參數是在程式代碼范例外部設定。

若開關設為 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 方法。

Note

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

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？