Trace.Write 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將追蹤資訊寫入 Listeners 集合中的追蹤接聽項。
多載
Write(Object) |
將物件的 ToString() 方法值寫入 Listeners 集合中的追蹤接聽項。 |
Write(String) |
將訊息寫入 Listeners 集合中的追蹤接聽項。 |
Write(Object, String) |
將物件之 ToString() 方法的分類名稱和值寫入 Listeners 集合中的追蹤接聽項。 |
Write(String, String) |
將分類名稱和訊息寫入 Listeners 集合中的追蹤接聽項。 |
Write(Object)
- 來源:
- 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)
參數
- 屬性
範例
下列範例會 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("...")
。
另請參閱
適用於
Write(String)
- 來源:
- 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
要寫入的訊息。
- 屬性
範例
下列範例會 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("...")
。
另請參閱
適用於
Write(Object, String)
- 來源:
- 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)
參數
- category
- String
用來組織輸出的類別名稱。
- 屬性
範例
下列範例會 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("...")
。
另請參閱
適用於
Write(String, String)
- 來源:
- 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
用來組織輸出的類別名稱。
- 屬性
範例
下列範例會 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("...")
。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應