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 メソッドのいずれかを呼び出すと、内部的に呼び出されます。

注:

カスタム イベント情報を表示用に書式設定する場合は、ToString メソッドではなく、FormatCustomEventDetails メソッドをオーバーライドします。 これにより、機密性の高いシステム情報の上書きや改ざんを回避できます。

適用対象