WebBaseEvent.FormatCustomEventDetails(WebEventFormatter) 方法
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供事件資訊的標準格式。
public:
virtual void FormatCustomEventDetails(System::Web::Management::WebEventFormatter ^ formatter);
C#
public virtual void FormatCustomEventDetails (System.Web.Management.WebEventFormatter formatter);
abstract member FormatCustomEventDetails : System.Web.Management.WebEventFormatter -> unit
override this.FormatCustomEventDetails : System.Web.Management.WebEventFormatter -> unit
Public Overridable Sub FormatCustomEventDetails (formatter As WebEventFormatter)
- formatter
- WebEventFormatter
WebEventFormatter 物件,其中包含格式化的事件資訊。
下列程式碼範例示範如何自訂 FormatCustomEventDetails 方法。
C#
//Formats Web request event information.
public override void FormatCustomEventDetails(
WebEventFormatter formatter)
{
base.FormatCustomEventDetails(formatter);
// Add custom data.
formatter.AppendLine("");
formatter.IndentationLevel += 1;
formatter.TabSize = 4;
formatter.AppendLine(
"*SampleWebBaseEvent Start *");
// Display custom event information.
formatter.AppendLine(customCreatedMsg);
formatter.AppendLine(customRaisedMsg);
formatter.AppendLine(firingRecordInfo);
formatter.AppendLine(
"* SampleWebBaseEvent End *");
formatter.IndentationLevel -= 1;
}
'Formats Web request event information.
Public Overrides Sub FormatCustomEventDetails( _
ByVal formatter As WebEventFormatter)
MyBase.FormatCustomEventDetails(formatter)
' Add custom data.
formatter.AppendLine("")
formatter.IndentationLevel += 1
formatter.TabSize = 4
formatter.AppendLine("*SampleWebBaseEvent Start *")
formatter.AppendLine("Custom information goes here")
formatter.AppendLine("* SampleWebBaseEvent End *")
' Display custom event timing.
formatter.AppendLine(customCreatedMsg)
formatter.AppendLine(customRaisedMsg)
formatter.IndentationLevel -= 1
End Sub
方法 FormatCustomEventDetails 會為事件資訊提供統一格式,如果必須記錄事件資料,稍後再向使用者呈現,這非常有用。 當提供者叫用其中 ToString 一個方法時,會在內部呼叫它。
備註
當您格式化自訂事件資訊以供顯示時,請覆寫 FormatCustomEventDetails 方法,而不是 ToString 方法。 這可避免覆寫或竄改敏感性系統資訊。
產品 | 版本 |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |