WebRequestErrorEvent Класс

Определение

Пространство имен:

System.Web.Management

Сборка:

System.Web.dll

Определяет событие, содержащее сведения об ошибках веб-запросов.

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

public class WebRequestErrorEvent : System.Web.Management.WebBaseErrorEvent

type WebRequestErrorEvent = class
    inherit WebBaseErrorEvent

Public Class WebRequestErrorEvent
Inherits WebBaseErrorEvent

Наследование

Object

WebBaseEvent

WebManagementEvent

WebBaseErrorEvent

WebRequestErrorEvent

Производный

System.Web.Management.WebServiceErrorEvent

Примеры

Следующий пример кода состоит из двух частей. Первая часть — это фрагмент файла конфигурации, который позволяет ASP.NET использовать пользовательское событие. Во второй части показано, как наследоваться от WebRequestErrorEvent класса для создания пользовательского события.

<healthMonitoring enabled="true" heartBeatInterval="0">  
  <eventMappings>  
    <add  name="SampleWebRequestErrorEvent" type="SamplesAspNet.SampleWebRequestErrorEvent,webrequesterrorevent,Version=1.0.1573.21654, Culture=neutral, PublicKeyToken=63ada862a6c5af13, processorArchitecture=MSIL"/>  
  </eventMappings>  

  <rules>  
    <add   
      name="Custom Web Request Error Events"  
      eventName="SampleWebRequestErrorEvent"   
      provider="EventLogProvider"    
      profile="Critical"/>  
  </rules>  
</healthMonitoring>  

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

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

        // Invoked in case of events 
        // identified only by their event code.
        public SampleWebRequestErrorEvent(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 SampleWebRequestErrorEvent(
            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 SampleWebRequestErrorEvent.
        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(
                "** SampleWebRequestEvent Start **");

            // Add custom data.
            formatter.AppendLine(eventInfo.ToString());

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

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


' Implements a custom WebRequestErrorEvent class. 
Public Class SampleWebRequestErrorEvent
   Inherits WebRequestErrorEvent
   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 SampleWebRequestErrorEvent.
   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( _
        "** SampleWebRequestEvent Start **")

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

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

    End Sub

End Class

Комментарии

Возникает, WebRequestErrorEvent если во время веб-запроса возникает ошибка. Приложение должно использовать это событие для получения сведений, связанных с запросами, как определено классами и классами WebRequestInformation WebThreadInformation .

Примечание

В большинстве случаев вы будете использовать стандартные ASP.NET типы мониторинга работоспособности и управлять их поведением, задав healthMonitoring раздел конфигурации. Можно также создать настраиваемые типы, как показано в следующем примере. Если вы создаете пользовательский тип события и хотите добавить собственные сведения, настройте FormatCustomEventDetails метод, это позволит избежать перезаписи или изменения конфиденциальной системной информации.

Конструкторы

WebRequestErrorEvent(String, Object, Int32, Exception)	Инициализирует класс WebRequestErrorEvent с указанными параметрами события.
WebRequestErrorEvent(String, Object, Int32, Int32, Exception)	Инициализирует класс WebRequestErrorEvent с указанными параметрами события.

Свойства

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(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FormatCustomEventDetails(WebEventFormatter)	Обеспечивает стандартное форматирование сведений о событии. (Унаследовано от WebBaseEvent)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IncrementPerfCounters()	Используется внутренним образом для увеличения значения соответствующих счетчиков производительности.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Raise()	Порождает событие, уведомляя любого настроенного поставщика о произошедшем событии. (Унаследовано от WebBaseEvent)
ToString()	Форматирует сведения события для последующего отображения. (Унаследовано от WebBaseEvent)
ToString(Boolean, Boolean)	Форматирует сведения события для последующего отображения. (Унаследовано от WebBaseEvent)

См. также раздел

• Общие сведения о мониторинге работоспособности ASP.NET