WebFailureAuditEventとは? わかりやすく解説

WebFailureAuditEvent クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

セキュリティ障害に関する情報を提供します。

名前空間: System.Web.Management
アセンブリ: System.Web (system.web.dll 内)
構文構文

Public Class WebFailureAuditEvent
    Inherits WebAuditEvent
Dim instance As WebFailureAuditEvent
public class WebFailureAuditEvent : WebAuditEvent
public ref class WebFailureAuditEvent : public
 WebAuditEvent
public class WebFailureAuditEvent extends WebAuditEvent
public class WebFailureAuditEvent extends
 WebAuditEvent
解説解説

運用および操作の担当者は、ASP.NET Health Monitoring を使用して、配置されている Web アプリケーションを管理できます。System.Web.Management 名前空間には、アプリケーションの状態データをパッケージ化する状態イベント型、およびそのデータを処理するプロバイダ型が含まれます。また、状態イベント管理を支援するサポート型も含まれます。

WebFailureAuditEvent クラスは、セキュリティ操作が失敗すると使用されます。たとえば、Web 要求に対する URL 承認が失敗した場合です。

既定では、ASP.NET は次の機能について WebFailureAuditEvent イベントを発生させるよう構成されています。

WebFailureAuditEvent イベントが発生すると、ASP.NET Health Monitoring は関連する Audit Failure Events Raised パフォーマンス カウンタをインクリメントし、healthMonitoring 構成をチェックしてそのイベントをサブスクライブするプロバイダがあるかどうかを確認します。このイベントをサブスクライブするプロバイダがある場合、ASP.NET はそのイベントをディスパッチして処理させます。

メモメモ

Audit Failure Events Raised パフォーマンス カウンタをシステム モニタ (PerfMon) に表示するには、[カウンタの追加] ウィンドウで [パフォーマンス オブジェクト] ドロップダウンリストの [ASP.NET] を選択し、[Audit Failure Events Raised] パフォーマンス カウンタを選択して、[追加] ボタンをクリックします。詳細については、MSDN の IIS に関するドキュメントの「Using the System Monitor (PerfMon) with ASP.NET Applications」を参照してください。メモ   ほとんどの場合、ASP.NET 状態監視型は実装のまま使用でき、healthMonitoring 構成セクションに値を指定して ASP.NET Health Monitoring system を制御できます。状態監視型の派生として独自のイベントおよびプロバイダを作成することもできます。WebFailureAuditEvent クラスの派生の例については、このトピックの例を参照してください。

継承時の注意 カスタム イベント情報を表示用に書式設定する場合は、ToString メソッドではなく、FormatCustomEventDetails メソッドをオーバーライドします。これにより、重要なシステム情報に対する上書きや不正な変更を防げます。

使用例使用例

WebFailureAuditEvent クラスの派生としてカスタム監査イベントを作成する方法を次のコード例に示します。

Imports System
Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebFailureAuditEvent class. 

Public Class SampleWebFailureAuditEvent
    Inherits System.Web.Management.WebFailureAuditEvent
    Private customCreatedMsg, customRaisedMsg As
 String
    
    
    
    ' Invoked in case of events identified only by their event code.
    Public Sub New(ByVal
 msg As String, _
    ByVal eventSource As Object,
 ByVal eventCode As Integer)
        MyBase.New(msg, eventSource, eventCode)
        ' Perform custom initialization.
        customCreatedMsg = String.Format("Event
 created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub 'New
    
    
    ' Invoked in case of events identified by their event code and 
    ' event detailed code.
    Public Sub New(ByVal
 msg As String, ByVal eventSource
 As Object, _
    ByVal eventCode As Integer,
 ByVal detailedCode As Integer)
        MyBase.New(msg, eventSource, eventCode, detailedCode)
        ' Perform custom initialization.
        customCreatedMsg = String.Format("Event
 created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub 'New
    
    
    
    ' Raises the SampleWebFailureAuditEvent.
    Public Overrides Sub
 Raise() 
        ' Perform custom processing.
        customRaisedMsg = String.Format("Event
 raised at: {0}", _
        DateTime.Now.TimeOfDay.ToString())
        
        ' Raise the event.
        WebBaseEvent.Raise(Me)
    
    End Sub 'Raise
    
    
    ' Obtains the current thread information.
    Public Function GetRequestInformation()
 As WebRequestInformation 
        ' No customization is allowed.
        Return RequestInformation
    
    End Function 'GetRequestInformation
    
    
    'Formats Web request event information.
    'This method is invoked indirectly by the provider 
    'using one of the overloaded ToString methods.
    Public Overrides Sub
 FormatCustomEventDetails(ByVal formatter _
    As WebEventFormatter)
        MyBase.FormatCustomEventDetails(formatter)

        ' Add custom data.
        formatter.AppendLine("")

        formatter.IndentationLevel += 1
        formatter.AppendLine("******** SampleWebFailureAuditEvent
 Start ********")
        formatter.AppendLine(String.Format("Request
 path: {0}", _
        RequestInformation.RequestPath))
        formatter.AppendLine(String.Format("Request
 Url: {0}", _
        RequestInformation.RequestUrl))

        ' Display custom event timing.
        formatter.AppendLine(customCreatedMsg)
        formatter.AppendLine(customRaisedMsg)

        formatter.AppendLine("******** SampleWebFailureAuditEvent
 End ********")

        formatter.IndentationLevel -= 1

    End Sub 'FormatCustomEventDetails
 

End Class 'SampleWebFailureAuditEvent

using System;
using System.Text;
using System.Web;
using System.Web.Management;

namespace SamplesAspNet
{
    // Implements a custom WebFailureAuditEvent class. 
    public class SampleWebFailureAuditEvent
 : 
        System.Web.Management.WebFailureAuditEvent
    {
        private string customCreatedMsg, customRaisedMsg;


        // Invoked in case of events identified only by their event
 code.
        public SampleWebFailureAuditEvent(string
 msg, object eventSource,
            int eventCode):
        base(msg, eventSource, eventCode)
        {
            // Perform custom initialization.
            customCreatedMsg =
                string.Format("Event created at: {0}"
,
                DateTime.Now.TimeOfDay.ToString());
        }


        // Invoked in case of events identified by their event code
 and 
        // event detailed code.
        public SampleWebFailureAuditEvent(string
 msg, object eventSource,
            int eventCode, int detailedCode):
        base(msg, eventSource, eventCode, detailedCode)
        {
            // Perform custom initialization.
            customCreatedMsg =
            string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }



        // Raises the SampleWebFailureAuditEvent.
        public override void Raise()
        {
            // Perform custom processing.
            customRaisedMsg =
                string.Format("Event raised at: {0}",
 
                DateTime.Now.TimeOfDay.ToString());

            // Raise the event.
            WebBaseEvent.Raise(this);
        }


        // Obtains the current thread information.
        public WebRequestInformation GetRequestInformation()
        {
            // No customization is allowed.
            return RequestInformation;
        }


        //Formats Web request event information.
        //This method is invoked indirectly by the provider 
        //using one of the overloaded ToString methods.
        public override void FormatCustomEventDetails(WebEventFormatter
 formatter)
        {
            base.FormatCustomEventDetails(formatter);

            // Add custom data.
            formatter.AppendLine("");

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "******** SampleWebFailureAuditEvent Start ********");
            formatter.AppendLine(string.Format("Request path:
 {0}",
                RequestInformation.RequestPath));
            formatter.AppendLine(string.Format("Request Url:
 {0}",
                RequestInformation.RequestUrl));

            // Display custom event timing.
            formatter.AppendLine(customCreatedMsg);
            formatter.AppendLine(customRaisedMsg);

            formatter.AppendLine(
                "******** SampleWebFailureAuditEvent End ********");

            formatter.IndentationLevel -= 1;

        }
    }

}

次に示すのは、ASP.NET で WebFailureAuditEvent イベントを使用できるようにする方法を示す構成の抜粋です。

<healthMonitoring 
enabled="true"
heartBeatInterval="0"> 
<providers>
							
<eventMappings>
							
</healthMonitoring>
継承階層継承階層
System.Object
   System.Web.Management.WebBaseEvent
     System.Web.Management.WebManagementEvent
       System.Web.Management.WebAuditEvent
        System.Web.Management.WebFailureAuditEvent
           System.Web.Management.WebAuthenticationFailureAuditEvent
           System.Web.Management.WebViewStateFailureAuditEvent
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
WebFailureAuditEvent メンバ
System.Web.Management 名前空間
WebAuditEvent クラス
WebSuccessAuditEvent
WebEventCodes クラス
その他の技術情報
healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視
ASP.NET ビューステート

WebFailureAuditEvent コンストラクタ (String, Object, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたパラメータを使用して、WebFailureAuditEvent クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Management
アセンブリ: System.Web (system.web.dll 内)
構文構文

Protected Friend Sub New
 ( _
    message As String, _
    eventSource As Object, _
    eventCode As Integer _
)
Dim message As String
Dim eventSource As Object
Dim eventCode As Integer

Dim instance As New WebFailureAuditEvent(message,
 eventSource, eventCode)
protected internal WebFailureAuditEvent (
    string message,
    Object eventSource,
    int eventCode
)
protected public:
WebFailureAuditEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode
)
protected WebFailureAuditEvent (
    String message, 
    Object eventSource, 
    int eventCode
)
protected internal function
 WebFailureAuditEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int
)

パラメータ

message

イベントの説明。

eventSource

イベントのソースであるオブジェクト。

eventCode

イベントに関連付けられているコード。カスタム イベントを実装する場合、イベント コードを WebExtendedBase より大きくする必要があります。

解説解説
使用例使用例

このコンストラクタを SampleWebFailureAuditEvent クラスで呼び出す方法を次のコード例に示します。このコード例は、WebFailureAuditEvent クラスのトピックで取り上げているコード例の一部分です。

' Invoked in case of events identified only by their event code.
Public Sub New(ByVal
 msg As String, _
ByVal eventSource As Object,
 ByVal eventCode As Integer)
    MyBase.New(msg, eventSource, eventCode)
    ' Perform custom initialization.
    customCreatedMsg = String.Format("Event
 created at: {0}", _
    DateTime.Now.TimeOfDay.ToString())

End Sub 'New

// Invoked in case of events identified only by their event code.
public SampleWebFailureAuditEvent(string msg,
 object eventSource,
    int eventCode):
base(msg, eventSource, eventCode)
{
    // Perform custom initialization.
    customCreatedMsg =
        string.Format("Event created at: {0}",
        DateTime.Now.TimeOfDay.ToString());
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
WebFailureAuditEvent クラス
WebFailureAuditEvent メンバ
System.Web.Management 名前空間

WebFailureAuditEvent コンストラクタ

WebFailureAuditEvent クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
WebFailureAuditEvent (String, Object, Int32) 指定されたパラメータを使用して、WebFailureAuditEvent クラスの新しいインスタンスを初期化します。
WebFailureAuditEvent (String, Object, Int32, Int32) 指定されたパラメータを使用して、WebFailureAuditEvent クラスの新しいインスタンスを初期化します。
参照参照

関連項目

WebFailureAuditEvent クラス
WebFailureAuditEvent メンバ
System.Web.Management 名前空間

WebFailureAuditEvent コンストラクタ (String, Object, Int32, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたパラメータを使用して、WebFailureAuditEvent クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Management
アセンブリ: System.Web (system.web.dll 内)
構文構文

Protected Friend Sub New
 ( _
    message As String, _
    eventSource As Object, _
    eventCode As Integer, _
    eventDetailCode As Integer _
)
Dim message As String
Dim eventSource As Object
Dim eventCode As Integer
Dim eventDetailCode As Integer

Dim instance As New WebFailureAuditEvent(message,
 eventSource, eventCode, eventDetailCode)
protected internal WebFailureAuditEvent (
    string message,
    Object eventSource,
    int eventCode,
    int eventDetailCode
)
protected public:
WebFailureAuditEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode, 
    int eventDetailCode
)
protected WebFailureAuditEvent (
    String message, 
    Object eventSource, 
    int eventCode, 
    int eventDetailCode
)
protected internal function
 WebFailureAuditEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int, 
    eventDetailCode : int
)

パラメータ

message

イベントの説明。

eventSource

イベントのソースであるオブジェクト。

eventCode

イベントに関連付けられているコード。カスタム イベントを実装する場合、イベント コードを WebExtendedBase より大きくする必要があります。

eventDetailCode

イベントの詳細な識別子を指定する WebEventCodes 値。

解説解説
使用例使用例

このコンストラクタを SampleWebFailureAuditEvent クラスで呼び出す方法を次のコード例に示します。このコード例は、WebFailureAuditEvent クラスのトピックで取り上げているコード例の一部分です。

' Invoked in case of events identified by their event code and 
' event detailed code.
Public Sub New(ByVal
 msg As String, ByVal eventSource
 As Object, _
ByVal eventCode As Integer,
 ByVal detailedCode As Integer)
    MyBase.New(msg, eventSource, eventCode, detailedCode)
    ' Perform custom initialization.
    customCreatedMsg = String.Format("Event
 created at: {0}", _
    DateTime.Now.TimeOfDay.ToString())

End Sub 'New


// Invoked in case of events identified by their event code and 
// event detailed code.
public SampleWebFailureAuditEvent(string msg,
 object eventSource,
    int eventCode, int detailedCode):
base(msg, eventSource, eventCode, detailedCode)
{
    // Perform custom initialization.
    customCreatedMsg =
    string.Format("Event created at: {0}",
        DateTime.Now.TimeOfDay.ToString());
}

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
WebFailureAuditEvent クラス
WebFailureAuditEvent メンバ
System.Web.Management 名前空間

WebFailureAuditEvent プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ ApplicationInformation  監視中の現在のアプリケーションに関する情報を格納している WebApplicationInformation オブジェクトを取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventCode  イベントに関連付けられているコード値を取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventDetailCode  イベント詳細コードを取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventID  イベントに関連付けられている識別子を取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventOccurrence  イベントが発生した回数を表すカウンタを取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventSequence  アプリケーションによるイベントの発生回数を取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventSource  イベントを発生させるオブジェクトを取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventTime  イベントが発生した時刻を取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ EventTimeUtc  イベントが発生した時刻を取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ Message  イベントを説明するメッセージを取得します。 ( WebBaseEvent から継承されます。)
パブリック プロパティ ProcessInformation  ASP.NET アプリケーション ホスト プロセスに関する情報を取得します。 ( WebManagementEvent から継承されます。)
パブリック プロパティ RequestInformation  Web 要求に関連付けられた情報を取得します。 ( WebAuditEvent から継承されます。)
参照参照

関連項目

WebFailureAuditEvent クラス
System.Web.Management 名前空間
WebAuditEvent クラス
WebSuccessAuditEvent
WebEventCodes クラス

その他の技術情報

healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視
ASP.NET ビューステート

WebFailureAuditEvent メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

WebFailureAuditEvent クラス
System.Web.Management 名前空間
WebAuditEvent クラス
WebSuccessAuditEvent
WebEventCodes クラス

その他の技術情報

healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視
ASP.NET ビューステート

WebFailureAuditEvent メンバ

セキュリティ障害に関する情報を提供します。

WebFailureAuditEvent データ型で公開されるメンバを以下の表に示します。


プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド WebFailureAuditEvent オーバーロードされます。 WebFailureAuditEvent クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ ApplicationInformation  監視中の現在のアプリケーションに関する情報を格納している WebApplicationInformation オブジェクトを取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventCode  イベントに関連付けられているコード値を取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventDetailCode  イベント詳細コードを取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventID  イベントに関連付けられている識別子を取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventOccurrence  イベントが発生した回数を表すカウンタを取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventSequence  アプリケーションによるイベントの発生回数を取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventSource  イベントを発生させるオブジェクトを取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventTime  イベントが発生した時刻を取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ EventTimeUtc  イベントが発生した時刻を取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ Message  イベントを説明するメッセージを取得します。(WebBaseEvent から継承されます。)
パブリック プロパティ ProcessInformation  ASP.NET アプリケーション ホスト プロセスに関する情報を取得します。(WebManagementEvent から継承されます。)
パブリック プロパティ RequestInformation  Web 要求に関連付けられた情報を取得します。(WebAuditEvent から継承されます。)
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

WebFailureAuditEvent クラス
System.Web.Management 名前空間
WebAuditEvent クラス
WebSuccessAuditEvent
WebEventCodes クラス

その他の技術情報

healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視
ASP.NET ビューステート



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「WebFailureAuditEvent」の関連用語

WebFailureAuditEventのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



WebFailureAuditEventのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS