WebBaseErrorEvent 類別

定義

public ref class WebBaseErrorEvent : System::Web::Management::WebManagementEvent

public class WebBaseErrorEvent : System.Web.Management.WebManagementEvent

type WebBaseErrorEvent = class
    inherit WebManagementEvent

Public Class WebBaseErrorEvent
Inherits WebManagementEvent

繼承

Object

WebBaseEvent

WebManagementEvent

WebBaseErrorEvent

衍生

System.Web.Management.WebErrorEvent

System.Web.Management.WebRequestErrorEvent

範例

以下程式碼範例分為兩部分。 第一個是一段設定檔的摘錄，讓 ASP.NET 健康監控能使用源自 WebBaseErrorEvent 類別的事件。 第二個說明如何從 WebBaseErrorEvent 類別推導來建立自訂事件。

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

  <providers>
    <!-- Define the custom provider that
         processes custom Web request events. -->
    <add name="SampleWebEventProvider"
      type="SamplesAspNet.SampleEventProvider,
      webeventprovider,Version=1.0.1573.18094,
      Culture=neutral, PublicKeyToken=b5a57a9a9d487cf4,
      processorArchitecture=MSIL"/>
  </providers>

  <eventMappings>

    <!--  Define the event source that issues custom events.   -->
    <add  name="SampleWebBaseErrorEvent"
      type="SamplesAspNet.SampleWebBaseErrorEvent,
      webbaseerrorevent,Version=1.0.1573.21549, Culture=neutral,
      PublicKeyToken=2a0b23915ac7352b, processorArchitecture=MSIL"/>
  </eventMappings>

  <rules>
    <!-- Associate custom event with related
      custom provider -->
    <add
       name="Custom Web Base Errors"
       eventName="SampleWebBaseErrorEvent"
       provider="SampleWebEventProvider"
       profile="Custom"/>
  </rules>

</healthMonitoring>

以下程式碼說明如何從 WebBaseErrorEvent 類別推導出自訂事件。

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;
        }
    }
}

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
   
   
   ' 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
   
   
   ' 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
   
   ' 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

End Class

備註

ASP.NET 健康監控讓生產與營運人員能管理已部署的網頁應用程式。 System.Web.Management命名空間包含負責包裝應用程式健康狀態資料的健康事件類型，以及負責處理這些資料的提供者類型。 同時也包含協助健康事件管理的支援類型。

該 WebBaseErrorEvent 類別是代表錯誤狀況的健康監控事件的基底類別。 ASP.NET 使用 WebBaseErrorEvent 及其衍生型別來表示網頁應用程式生命週期中的錯誤狀況。

另請參閱

• WebManagementEvent
• WebErrorEvent
• WebRequestEvent
• ASP.NET 狀況監控 概觀