WebErrorEvent

.NET Framework クラス ライブラリ リファレンス

WebErrorEvent クラス

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

システム エラーに関する情報を提供します。

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

Visual Basic (宣言)

Public Class WebErrorEvent
    Inherits WebBaseErrorEvent

Visual Basic (使用法)

Dim instance As WebErrorEvent

C#

public class WebErrorEvent : WebBaseErrorEvent

C++

public ref class WebErrorEvent : public
 WebBaseErrorEvent

J#

public class WebErrorEvent extends WebBaseErrorEvent

JScript

public class WebErrorEvent extends
 WebBaseErrorEvent

解説

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

WebErrorEvent は、問題が生じたことによるエラーに関する情報を、構成コードまたはアプリケーション コードと共に提供します。たとえば、ページでエラーが見つかった場合に ASP.NET が発生させるエラーです。

メモ
ほとんどの場合、ASP.NET 状態監視型は実装のまま使用でき、healthMonitoring 構成セクションに値を指定して ASP.NET Health Monitoring system を制御できます。状態監視型の派生として独自のイベントおよびプロバイダを作成することもできます。WebErrorEvent クラスの派生の例については、このトピックの例を参照してください。

使用例

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

また、ASP.NET でこのカスタム イベントを使用できるようにする構成ファイルの抜粋も示します。

<healthMonitoring 
  enabled="true" heartBeatInterval="0">

  <eventMappings>

    <add  name="SampleWebErrorEvent" type="SamplesAspNet.SampleWebErrorEvent,weberrorevent,Version=1.0.1573.21549,
 Culture=neutral, PublicKeyToken=2a0b23915ac7352b, processorArchitecture=MSIL"/>

  </eventMappings>
  
  <profiles>
    <add name="Custom"
      minInstances="1"
      maxLimit="Infinite"
      minInterval="00:00:00" />
  </profiles>

  <rules>
    <clear />

    <add name="Custom Web Error Event" 
      eventName="SampleWebErrorEvent"
      provider="EventLogProvider" 
      profile="Custom" />
  </rules>

</healthMonitoring>

Visual Basic

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


' Implements a custom WebErrorEvent class. 

Public Class SampleWebErrorEvent
   Inherits WebErrorEvent
   Private eventInfo As StringBuilder
   
   
   ' 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,
 ByVal e As Exception)
        MyBase.New(msg, eventSource, eventCode, e)
        ' Perform custom initialization.
        eventInfo = New StringBuilder()
        eventInfo.Append(String.Format( _
        "Event created at: ", EventTime.ToString()))
    End Sub 'New
   
   
   ' Invoked in case of events identified 
   ' by their event code.and 
   ' related event detailed code.
    Public Sub New(ByVal
 msg As String, ByVal eventSource
 _
    As Object, ByVal eventCode
 As Integer, _
    ByVal detailedCode As Integer,
 ByVal e As Exception)
        MyBase.New(msg, eventSource, _
        eventCode, detailedCode, e)
        ' Perform custom initialization.
        eventInfo = New StringBuilder()
        eventInfo.Append(String.Format( _
        "Event created at: ", EventTime.ToString()))
    End Sub 'New
   
   
   ' Raises the SampleWebErrorEvent.
   Public Overrides Sub
 Raise()
      ' Perform custom processing. 
        eventInfo.Append(String.Format( _
        "Event raised at: ", EventTime.ToString()))
      
      ' Raise the event.
      MyBase.Raise()
   End Sub 'Raise
   
   ' Obtains the current request information.
   Public Function GetRequestInfo() As
 String
      Dim reqInfo As String
 = GetRequestInfo()
      Return reqInfo
   End Function 'GetRequestInfo
   
   
   ' Obtains the current thread information.
   Public Function GetThreadInfo() As
 String
      Dim threadInfo As String
 = GetThreadInfo()
      Return threadInfo
   End Function 'GetThreadInfo
   
   
   ' Obtains the current process information.
   Public Function GetProcessInfo() As
 String
      Dim procInfo As String
 = GetProcessInfo()
      Return procInfo
   End Function 'GetProcessInfo
   
   
   '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.AppendLine( _
        "** SampleWebErrorEvent Start **")

        formatter.AppendLine(eventInfo.ToString())

        formatter.AppendLine( _
        "** SampleWebBaseErrorEvent End **")

        formatter.IndentationLevel -= 1
    End Sub 'FormatCustomEventDetails
 

End Class 'SampleWebErrorEvent
 

C#

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

namespace Samples.AspNet.Management
{
  // Implements a custom WebErrorEvent class. 

    public class SampleWebErrorEvent : WebErrorEvent
    {
        private StringBuilder eventInfo;

        // Invoked in case of events identified 
        // only by their event code.
        public SampleWebErrorEvent(string msg,
 
            object eventSource, int eventCode, Exception e)
            :
        base(msg, eventSource, eventCode, e)
        {
            // Perform custom initialization.
            eventInfo = new StringBuilder();
            eventInfo.Append(string.Format(
                "Event created at: ", EventTime.ToString()));
        }


        // Invoked in case of events identified 
        // by their event code.and 
        // related event detailed code.
        public SampleWebErrorEvent(string msg,
 
            object eventSource, int eventCode, 
            int detailedCode, Exception e):
          base(msg, eventSource, 
            eventCode, detailedCode, e)
        {
            // Perform custom initialization.
            eventInfo = new StringBuilder();
            eventInfo.Append(string.Format(
                "Event created at: ", EventTime.ToString()));
        }


        // Raises the SampleWebErrorEvent.
        public override void Raise()
        {
            // Perform custom processing. 
            eventInfo.Append(string.Format(
                "Event raised at: ", EventTime.ToString()));

            // Raise the event.
            base.Raise();
        }

        // Obtains the current request information.
        public string GetRequestInfo()
        {
            string reqInfo = GetRequestInfo();
            return reqInfo;
        }


        // Obtains the current thread information.
        public string GetThreadInfo()
        {
            string threadInfo = GetThreadInfo();
            return threadInfo;
        }


        // Obtains the current process information.
        public string GetProcessInfo()
        {
            string procInfo = GetProcessInfo();
            return procInfo;
        }


        //Formats Web request event information..
        public override void FormatCustomEventDetails(
            WebEventFormatter formatter)
        {

            base.FormatCustomEventDetails(formatter);


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

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "** SampleWebErrorEvent Start **");
          
            formatter.AppendLine(eventInfo.ToString());

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

            formatter.IndentationLevel -= 1;

            

        }
    }

}

継承階層

System.Object
   System.Web.Management.WebBaseEvent
     System.Web.Management.WebManagementEvent
       System.Web.Management.WebBaseErrorEvent
        System.Web.Management.WebErrorEvent

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebErrorEvent メンバ
System.Web.Management 名前空間
その他の技術情報
healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視

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

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

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim message As String
Dim eventSource As Object
Dim eventCode As Integer
Dim eventDetailCode As Integer
Dim exception As Exception

Dim instance As New WebErrorEvent(message,
 eventSource, eventCode, eventDetailCode, exception)

C#

protected internal WebErrorEvent (
    string message,
    Object eventSource,
    int eventCode,
    int eventDetailCode,
    Exception exception
)

C++

protected public:
WebErrorEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode, 
    int eventDetailCode, 
    Exception^ exception
)

J#

protected WebErrorEvent (
    String message, 
    Object eventSource, 
    int eventCode, 
    int eventDetailCode, 
    Exception exception
)

JScript

protected internal function
 WebErrorEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int, 
    eventDetailCode : int, 
    exception : Exception
)

パラメータ

message

イベントの説明。

eventSource

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

eventCode

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

eventDetailCode

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

exception

エラーに関連付けられている Exception。

解説

WebErrorEvent コンストラクタは、コードで直接使用するためのものではありません。ASP.NET によって呼び出されます。WebErrorEvent コンストラクタは、WebErrorEvent クラスの派生の場合に呼び出すことができます。

使用例

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

Visual Basic

' Invoked in case of events identified 
' by their event code.and 
' related event detailed code.
 Public Sub New(ByVal
 msg As String, ByVal eventSource
 _
 As Object, ByVal eventCode
 As Integer, _
 ByVal detailedCode As Integer,
 ByVal e As Exception)
     MyBase.New(msg, eventSource, _
     eventCode, detailedCode, e)
     ' Perform custom initialization.
     eventInfo = New StringBuilder()
     eventInfo.Append(String.Format( _
     "Event created at: ", EventTime.ToString()))
 End Sub 'New

C#

// Invoked in case of events identified 
// by their event code.and 
// related event detailed code.
public SampleWebErrorEvent(string msg, 
    object eventSource, int eventCode, 
    int detailedCode, Exception e):
  base(msg, eventSource, 
    eventCode, detailedCode, e)
{
    // Perform custom initialization.
    eventInfo = new StringBuilder();
    eventInfo.Append(string.Format(
        "Event created at: ", EventTime.ToString()));
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebErrorEvent クラス
WebErrorEvent メンバ
System.Web.Management 名前空間
WebEventCodes

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

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

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

指定したパラメータを使用して WebErrorEvent クラスを初期化します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim message As String
Dim eventSource As Object
Dim eventCode As Integer
Dim exception As Exception

Dim instance As New WebErrorEvent(message,
 eventSource, eventCode, exception)

C#

protected internal WebErrorEvent (
    string message,
    Object eventSource,
    int eventCode,
    Exception exception
)

C++

protected public:
WebErrorEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode, 
    Exception^ exception
)

J#

protected WebErrorEvent (
    String message, 
    Object eventSource, 
    int eventCode, 
    Exception exception
)

JScript

protected internal function
 WebErrorEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int, 
    exception : Exception
)

パラメータ

message

イベントの説明。

eventSource

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

eventCode

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

exception

エラーに関連付けられている Exception。

解説

WebErrorEvent コンストラクタは、コードで直接使用するためのものではありません。ASP.NET によって呼び出されます。WebErrorEvent コンストラクタは、WebErrorEvent クラスの派生の場合に呼び出すことができます。

使用例

このコンストラクタをカスタマイズするコードの例を次に示します。

Visual Basic

' 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,
 ByVal e As Exception)
     MyBase.New(msg, eventSource, eventCode, e)
     ' Perform custom initialization.
     eventInfo = New StringBuilder()
     eventInfo.Append(String.Format( _
     "Event created at: ", EventTime.ToString()))
 End Sub 'New

C#

// Invoked in case of events identified 
// only by their event code.
public SampleWebErrorEvent(string msg, 
    object eventSource, int eventCode, Exception e)
    :
base(msg, eventSource, eventCode, e)
{
    // Perform custom initialization.
    eventInfo = new StringBuilder();
    eventInfo.Append(string.Format(
        "Event created at: ", EventTime.ToString()));
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebErrorEvent クラス
WebErrorEvent メンバ
System.Web.Management 名前空間
WebEventCodes
WebEventCodes

WebErrorEvent コンストラクタ

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

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

参照

関連項目

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

WebErrorEvent プロパティ

パブリック プロパティ

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

参照

関連項目

WebErrorEvent クラス
System.Web.Management 名前空間

その他の技術情報

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

WebErrorEvent メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FormatCustomEventDetails	イベント情報の標準的な形式を提供します。 ( WebBaseEvent から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Raise	オーバーロードされます。 WebBaseEvent イベントを発生させ、構成されているプロバイダにこのイベントが発生したことを通知します。 ( WebBaseEvent から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーロードされます。 イベント情報を表示用に書式設定します。 ( WebBaseEvent から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	IncrementPerfCounters	オーバーライドされます。 パフォーマンス カウンタをインクリメントするために、内部的に使用されます。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

WebErrorEvent クラス
System.Web.Management 名前空間

その他の技術情報

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

WebErrorEvent メンバ

システム エラーに関する情報を提供します。

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

プロテクト コンストラクタ

	名前	説明
	WebErrorEvent	オーバーロードされます。 WebErrorEvent クラスの新しいインスタンスを初期化します。

パブリック プロパティ

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

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FormatCustomEventDetails	イベント情報の標準的な形式を提供します。 (WebBaseEvent から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Raise	オーバーロードされます。 WebBaseEvent イベントを発生させ、構成されているプロバイダにこのイベントが発生したことを通知します。 (WebBaseEvent から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーロードされます。 イベント情報を表示用に書式設定します。 (WebBaseEvent から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	IncrementPerfCounters	オーバーライドされます。 パフォーマンス カウンタをインクリメントするために、内部的に使用されます。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

WebErrorEvent クラス
System.Web.Management 名前空間

その他の技術情報

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