WebBaseEvent.FormatCustomEventDetails(WebEventFormatter) 方法

定義

命名空間:

System.Web.Management

組件:

System.Web.dll

提供事件資訊的標準格式。

public:
 virtual void FormatCustomEventDetails(System::Web::Management::WebEventFormatter ^ formatter);

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 方法。

//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 方法。 這可避免覆寫或竄改敏感性系統資訊。