WebRequestEvent Classe

Definição

Define a classe base para eventos que fornecem informação de pedidos Web.

public ref class WebRequestEvent : System::Web::Management::WebManagementEvent
public class WebRequestEvent : System.Web.Management.WebManagementEvent
type WebRequestEvent = class
    inherit WebManagementEvent
Public Class WebRequestEvent
Inherits WebManagementEvent
Herança

Exemplos

O exemplo de código seguinte mostra como derivar a partir da WebRequestEvent classe para criar um evento personalizado.


using System;
using System.Text;
using System.Web;
using System.Web.Management;
using System.Web.UI;
using System.Web.UI.WebControls;

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

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

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


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

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

        //Formats Web request event information.
        public override void FormatCustomEventDetails(
            WebEventFormatter formatter)
        {
            // Add custom data.
            formatter.AppendLine("");

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "* Custom Request Information Start *");

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

            formatter.AppendLine(
                "* Custom Request Information End *");

            formatter.IndentationLevel -= 1;
        }

    }
}
Imports System.Text
Imports System.Web
Imports System.Web.Management
Imports System.Web.UI
Imports System.Web.UI.WebControls


' Implements a custom WebRequestEvent. 
Public Class SampleWebRequestEvent
    Inherits System.Web.Management.WebRequestEvent
    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}", _
        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 eventDetailCode As Integer)
        MyBase.New(msg, eventSource, _
        eventCode, eventDetailCode)
        ' Perform custom initialization.
        customCreatedMsg = String.Format( _
        "Event created at: {0}", _
        EventTime.ToString())

    End Sub
    

    ' Raises the SampleWebRequestEvent.
    Public Overrides Sub Raise() 
        ' Perform custom processing.
        customRaisedMsg = String.Format( _
        "Event raised at: {0}", _
        EventTime.ToString())
        
        ' Raise the event.
        MyBase.Raise()
    
    End Sub
    
    
    'Formats Web request event information.
    Public Overrides Sub FormatCustomEventDetails( _
    ByVal formatter As WebEventFormatter)
        ' Add custom data.
        formatter.AppendLine("")

        formatter.IndentationLevel += 1
        formatter.AppendLine( _
        "* Custom Request Information Start *")

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

        formatter.AppendLine( _
        "* Custom Request Information End *")

        formatter.IndentationLevel -= 1

    End Sub
End Class

Segue-se um excerto do ficheiro de configuração que permite ao ASP.NET usar o evento personalizado.

<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="SampleWebRequestEvent"
type="SamplesAspNet.SampleWebRequestEvent,webrequestevent,Version=1.0.1573.23947, Culture=neutral, PublicKeyToken=e717d983a78c8ddb, processorArchitecture=MSIL"/>
    </eventMappings>

  <rules>
        <!-- Associate custom event with
        related custom provider -->
    <add
      name="CustomWebRequestEvent"
      eventName="SampleWebRequestEvent"
      provider="SampleWebEventProvider"
      profile="Critical"/>
  </rules>
</healthMonitoring>

Observações

É levantado WebRequestEvent em cada pedido da Web.

Utiliza a WebRequestInformation classe para obter informações de pedido.

Note

Na maioria dos casos, irá usar os tipos padrão de monitorização de ASP.NET de saúde e controlar o seu comportamento definindo a secção de configuração healthMonitoring. Também pode criar tipos personalizados, como mostrado no exemplo seguinte. Se criares o teu tipo de evento personalizado e precisares de adicionar a tua própria informação, personaliza o FormatCustomEventDetails método. Isto evitará sobrescrever ou manipular informações sensíveis do sistema.

Construtores

Name Description
WebRequestEvent(String, Object, Int32, Int32)

Inicializa a WebRequestEvent classe com parâmetros de evento especificados.

WebRequestEvent(String, Object, Int32)

Inicializa a WebRequestEvent classe com parâmetros de evento especificados.

Propriedades

Name Description
EventCode

Obtém o valor do código associado ao evento.

(Herdado de WebBaseEvent)
EventDetailCode

Obtém o código de detalhe do evento.

(Herdado de WebBaseEvent)
EventID

Obtém o identificador associado ao evento.

(Herdado de WebBaseEvent)
EventOccurrence

Recebe um contador que representa o número de vezes que o evento ocorreu.

(Herdado de WebBaseEvent)
EventSequence

Obtém o número de vezes que o evento foi levantado pela aplicação.

(Herdado de WebBaseEvent)
EventSource

Fica com o objeto que eleva o evento.

(Herdado de WebBaseEvent)
EventTime

Obtém a hora em que o evento foi levantado.

(Herdado de WebBaseEvent)
EventTimeUtc

Obtém a hora em que o evento foi levantado.

(Herdado de WebBaseEvent)
Message

Recebe a mensagem que descreve o evento.

(Herdado de WebBaseEvent)
ProcessInformation

Obtém informações sobre o processo de alojamento de aplicações ASP.NET.

(Herdado de WebManagementEvent)
RequestInformation

Obtém a informação associada ao pedido da aplicação Web.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FormatCustomEventDetails(WebEventFormatter)

Fornece formatação padrão da informação do evento.

(Herdado de WebBaseEvent)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IncrementPerfCounters()

Usado internamente para incrementar os contadores de desempenho.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Raise()

Levanta um evento ao notificar qualquer fornecedor configurado de que o evento ocorreu.

(Herdado de WebBaseEvent)
ToString()

Formata a informação do evento para fins de exibição.

(Herdado de WebBaseEvent)
ToString(Boolean, Boolean)

Formata a informação do evento para fins de exibição.

(Herdado de WebBaseEvent)

Aplica-se a

Ver também