WebManagementEvent

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

WebManagementEvent クラス

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

アプリケーションやプロセスの情報を保持するイベントの基本クラスを定義します。

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

Visual Basic (宣言)

Public Class WebManagementEvent
    Inherits WebBaseEvent

Visual Basic (使用法)

Dim instance As WebManagementEvent

C#

public class WebManagementEvent : WebBaseEvent

C++

public ref class WebManagementEvent : public
 WebBaseEvent

J#

public class WebManagementEvent extends WebBaseEvent

JScript

public class WebManagementEvent extends
 WebBaseEvent

解説

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

WebManagementEvent は、すべての ASP.NET 状態監視イベント型の基本クラスです。派生クラスで使用できるプロセス情報の取得には、WebProcessInformation クラスを使用します。

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

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

使用例

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

Visual Basic

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


' Implements a custom 
' WebManagementEvent class. 

Public Class SampleWebManagementEvent
   Inherits WebManagementEvent
   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)
        MyBase.New(msg, eventSource, eventCode)
        ' 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 eventDetailCode As Integer)
        MyBase.New(msg, eventSource, _
        eventCode, eventDetailCode)
        ' Perform custom initialization.
        eventInfo = New StringBuilder()
        eventInfo.Append(String.Format( _
        "Event created at: ", EventTime.ToString()))
    End Sub 'New
   
   
   ' Raises the SampleWebRequestEvent.
   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 process information.
   Public Function GetProcessInfo() As
 String
      Dim tempPi As New
 StringBuilder()
      Dim pi As WebProcessInformation = ProcessInformation
        tempPi.Append( _
        (pi.ProcessName + Environment.NewLine))
        tempPi.Append( _
        (pi.ProcessID.ToString() + Environment.NewLine))
        tempPi.Append( _
        (pi.AccountName + Environment.NewLine))
      Return tempPi.ToString()
   End Function 'GetProcessInfo
   
   
    Public Overrides Sub
 FormatCustomEventDetails( _
    ByVal formatter As WebEventFormatter)
        MyBase.FormatCustomEventDetails(formatter)

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

        formatter.IndentationLevel += 1
        formatter.AppendLine( _
        "** SampleWebManagementEvent Start **")

        ' Add custom data.
        formatter.AppendLine(eventInfo.ToString())

        formatter.AppendLine( _
        "** SampleWebManagementEvent End **")
    End Sub 'FormatCustomEventDetails
End Class 'SampleWebManagementEvent
 

C#

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

namespace Samples.AspNet.Management
{
    // Implements a custom 
    // WebManagementEvent class. 
    public class SampleWebManagementEvent :
 
        WebManagementEvent
    {
        private StringBuilder eventInfo;

        // Invoked in case of events 
        // identified only by their event code.
        public SampleWebManagementEvent(string
 msg, 
            object eventSource, int eventCode):
        base(msg, eventSource, eventCode)
        {
            // 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 SampleWebManagementEvent(string
 msg, 
            object eventSource, int eventCode, 
            int eventDetailCode):
          base(msg, eventSource, 
            eventCode, eventDetailCode)
        {
            // Perform custom initialization.
            eventInfo = new StringBuilder();
            eventInfo.Append(string.Format(
                "Event created at: ", 
                EventTime.ToString()));
        }


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


        // Obtains the current process information.
        public string GetProcessInfo()
        {
            StringBuilder tempPi = new StringBuilder();
            WebProcessInformation pi = ProcessInformation;
            tempPi.Append(
                pi.ProcessName + Environment.NewLine);
            tempPi.Append(
                pi.ProcessID.ToString() + Environment.NewLine);
            tempPi.Append(
                pi.AccountName + Environment.NewLine);
            return tempPi.ToString();
        }


        public override void FormatCustomEventDetails(
            WebEventFormatter formatter)
        {
            base.FormatCustomEventDetails(formatter);

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

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "** SampleWebManagementEvent Start **");
          
            // Add custom data.
            formatter.AppendLine(eventInfo.ToString());

            formatter.AppendLine(
                      "** SampleWebManagementEvent End **");
          
        }
    }

}

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

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

  <eventMappings>

    <add  name="SampleWebManagementEvent" type="SamplesAspNet.SampleWebManagementEvent,webmanagementevent,Version=1.0.1573.24438,
 Culture=neutral, PublicKeyToken=2f5f337ae5c9bdaa, processorArchitecture=MSIL"/>

  </eventMappings>

  <rules>
    <add 
      name="Custom WebManagementEvent"
      eventName="SampleWebManagementEvent"
      provider="EventLogProvider"
      profile="Critical"/>
  </rules>

</healthMonitoring>

継承階層

System.Object
   System.Web.Management.WebBaseEvent
    System.Web.Management.WebManagementEvent
       System.Web.Management.WebApplicationLifetimeEvent
       System.Web.Management.WebAuditEvent
       System.Web.Management.WebBaseErrorEvent
       System.Web.Management.WebHeartbeatEvent
       System.Web.Management.WebRequestEvent

スレッド セーフ

この型の 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

参照

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

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

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

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

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

名前空間: 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 _
)

Visual Basic (使用法)

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

Dim instance As New WebManagementEvent(message,
 eventSource, eventCode, eventDetailCode)

C#

protected internal WebManagementEvent (
    string message,
    Object eventSource,
    int eventCode,
    int eventDetailCode
)

C++

protected public:
WebManagementEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode, 
    int eventDetailCode
)

J#

protected WebManagementEvent (
    String message, 
    Object eventSource, 
    int eventCode, 
    int eventDetailCode
)

JScript

protected internal function
 WebManagementEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int, 
    eventDetailCode : int
)

パラメータ

message

イベントの説明。

eventSource

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

eventCode

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

eventDetailCode

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

解説

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

プラットフォーム

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

参照

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

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

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

Dim instance As New WebManagementEvent(message,
 eventSource, eventCode)

C#

protected internal WebManagementEvent (
    string message,
    Object eventSource,
    int eventCode
)

C++

protected public:
WebManagementEvent (
    String^ message, 
    Object^ eventSource, 
    int eventCode
)

J#

protected WebManagementEvent (
    String message, 
    Object eventSource, 
    int eventCode
)

JScript

protected internal function
 WebManagementEvent (
    message : String, 
    eventSource : Object, 
    eventCode : int
)

パラメータ

message

イベントの説明。

eventSource

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

eventCode

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

解説

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

プラットフォーム

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

参照

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

WebManagementEvent コンストラクタ

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

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

参照

関連項目

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

WebManagementEvent プロパティ

パブリック プロパティ

	名前	説明
	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 クラス
System.Web.Management 名前空間
WebAuditEvent クラス

その他の技術情報

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

WebManagementEvent メソッド

パブリック メソッド

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

	名前	説明
	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	パフォーマンス カウンタをインクリメントするために、内部的に使用されます。 ( WebBaseEvent から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

WebManagementEvent クラス
System.Web.Management 名前空間
WebAuditEvent クラス

その他の技術情報

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

WebManagementEvent メンバ

アプリケーションやプロセスの情報を保持するイベントの基本クラスを定義します。

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

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

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

パブリック プロパティ

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

パブリック メソッド

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

	名前	説明
	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	パフォーマンス カウンタをインクリメントするために、内部的に使用されます。 (WebBaseEvent から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

WebManagementEvent クラス
System.Web.Management 名前空間
WebAuditEvent クラス

その他の技術情報

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