WebApplicationLifetimeEvent Klas

Definitie

Vertegenwoordigt een belangrijke gebeurtenis in de levensduur van een toepassing.

public ref class WebApplicationLifetimeEvent : System::Web::Management::WebManagementEvent
public class WebApplicationLifetimeEvent : System.Web.Management.WebManagementEvent
type WebApplicationLifetimeEvent = class
    inherit WebManagementEvent
Public Class WebApplicationLifetimeEvent
Inherits WebManagementEvent
Overname
WebApplicationLifetimeEvent

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u kunt afleiden van de WebApplicationLifetimeEvent klasse om een aangepaste gebeurtenis te maken.


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

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

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

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


        // Raises the SampleWebRequestEvent.
        public override void Raise()
        {
            // Perform custom processing. 
            customRaisedMsg = string.Format(
                "Event raised at: {0}\n", 
                DateTime.Now.TimeOfDay.ToString());
            // Raise the event.
            base.Raise();
        }

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

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

            formatter.IndentationLevel += 1;
    
            formatter.TabSize = 4;
       
            formatter.AppendLine(
                 "*SampleWebApplicationLifetimeEvent Start *");
            formatter.AppendLine("Custom information goes here");
            formatter.AppendLine(
                "* SampleWebApplicationLifetimeEvent End *");
            // Display custom event timing.
            formatter.AppendLine(customCreatedMsg);
            formatter.AppendLine(customRaisedMsg);
        
            formatter.IndentationLevel -= 1;
        }
    }
}
Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebManagementEvent class. 

Public Class SampleWebApplicationLifetimeEvent
    Inherits System.Web.Management.WebApplicationLifetimeEvent
    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}", _
        DateTime.Now.TimeOfDay.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}", _
        DateTime.Now.TimeOfDay.ToString())
    End Sub


    ' Raises the SampleWebRequestEvent.
    Public Overrides Sub Raise() 
        ' Perform custom processing. 
        customRaisedMsg = _
        String.Format("Event raised at: {0}" + _
        vbLf, DateTime.Now.TimeOfDay.ToString())
        ' Raise the event.
        MyBase.Raise()
    
    End Sub
    
    '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.TabSize = 4

        formatter.AppendLine( _
        "*SampleWebApplicationLifetimeEvent Start *")
        formatter.AppendLine("Custom information goes here")
        formatter.AppendLine( _
        "* SampleWebApplicationLifetimeEvent End *")
        ' Display custom event timing.
        formatter.AppendLine(customCreatedMsg)
        formatter.AppendLine(customRaisedMsg)

        formatter.IndentationLevel -= 1

    End Sub
End Class

In het volgende configuratiebestandsfragment ziet u hoe u de sectie healthMonitoring van een configuratiebestand configureert om de hierboven gedefinieerde SampleWebApplicationLifetimeEvent-code toe te voegen aan het ASP.NET systeem voor statuscontrole. Als u de gebeurtenis aan het systeem wilt toevoegen, moet u de gebeurtenis definiëren door een nieuwe vermelding toe te voegen aan de eventMappings sectie en de gebeurtenis toe te wijzen aan een provider door een nieuwe vermelding toe te voegen aan de rules sectie.

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

    <eventMappings>
       <clear />
       <!-- Configure the application lifetime event -->
       <!-- object to handle the Web application events. -->
       <add name="SampleApplicationLifetimeEvents"
         type="System.Web.Management.SampleWebApplicationLifetimeEvent,
         System.Web,Version=2.0.3600.0,
         Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
     </eventMappings>

    <rules>
      <clear/>
       // Configure the connection between the
       // application lifetime event object
       // and the provider that must process it.
       <add name="Custom Application Events"
         eventName="SampleApplicationLifetimeEvents"
         provider="EventLogProvider"
         profile="Default"
         minInterval="00:01:00" />
    </rules>

</healthMonitoring>

Opmerkingen

ASP.NET statuscontrole maakt het productie- en operationele personeel mogelijk om geïmplementeerde webtoepassingen te beheren. De System.Web.Management naamruimte bevat de statusgebeurtenistypen die verantwoordelijk zijn voor het verpakken van statusgegevens van toepassingen en de providertypen die verantwoordelijk zijn voor het verwerken van deze gegevens. Het bevat ook ondersteunende typen die u helpen tijdens het beheer van statusevenementen.

Gebeurtenissen voor de levensduur van toepassingen omvatten gebeurtenissen zoals gebeurtenissen voor opstarten en afsluiten van toepassingen. Als een toepassing is beëindigd, kunt u bepalen waarom door het gerelateerde gebeurtenisberichtveld weer te geven.

Wanneer er een WebApplicationLifetimeEvent-exemplaar optreedt, werkt ASP.NET statuscontrole de prestatiemeteritems van toepassingslevens gebeurtenissen bij. U kunt deze gebeurtenissen registreren door het WebApplicationLifetimeEvent object toe te voegen aan de rules subsectie van de healthMonitoring sectie van het configuratiebestand, zoals wordt weergegeven in het volgende voorbeeld.

<rules>
  <add name="Application Events"
    eventName="Application Lifetime Events"
    provider="EventLogProvider"
    profile="Default"
    minInterval="00:01:00" />
</rules>

De prestatiemeteritem Levensduur van toepassing bevat het totaal van alle gebeurtenissen ASP.NET levensduur. Als u deze prestatiemeteritem wilt weergeven in System Monitor (PerfMon), selecteert u in het venster Add CountersASP.NET in de vervolgkeuzelijst Performance-object. Selecteer het prestatiemeteritem Application Lifetime Events en klik op de knop Toevoegen . Zie 'Using the System Monitor (PerfMon) with ASP.NET Applications' (Systeemmonitor gebruiken met ASP.NET-toepassingen) op MSDN voor meer informatie. Als u toestaat dat gebeurtenissen worden vastgelegd door de standaard-EventLogWebEventProvider, kunt u ze bekijken in Logboeken door het logboek Toekenning te selecteren.

Caution

Omdat het WebApplicationLifetimeEvent object een gebeurtenis met een hoog volume is, is logboekregistratie resource-intensief en kan uw systeem vertragen. Het kan er ook toe leiden dat andere gebeurtenissen worden overschreven in het geval van de EventLogWebEventProvider klasse vanwege het grote aantal gebeurtenissen en de manier waarop de logboekregistratie van gebeurtenissen werkt.

Note

In de meeste gevallen kunt u de ASP.NET statuscontroletypen gebruiken zoals geïmplementeerd en u kunt het systeem voor statusbewaking beheren door waarden op te geven in de sectie healthMonitoring configuratie. U kunt ook afleiden van de statuscontroletypen om uw eigen aangepaste gebeurtenissen en providers te maken. Zie het voorbeeld in dit onderwerp voor een voorbeeld van het afleiden van de WebApplicationLifetimeEvent klasse.

Notities voor overnemers

Wanneer u de aangepaste gebeurtenisgegevens voor weergave opmaakt, overschrijft u de FormatCustomEventDetails(WebEventFormatter) methode in plaats van de ToString methode. Dit voorkomt dat gevoelige systeemgegevens worden overschreven of gemanipuleerd.

Constructors

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

Initialiseert de WebApplicationLifetimeEvent klasse met behulp van de opgegeven parameters.

WebApplicationLifetimeEvent(String, Object, Int32)

Initialiseert de WebApplicationLifetimeEvent klasse met behulp van de opgegeven parameters.

Eigenschappen

Name Description
EventCode

Hiermee haalt u de codewaarde op die is gekoppeld aan de gebeurtenis.

(Overgenomen van WebBaseEvent)
EventDetailCode

Hiermee haalt u de gebeurtenisdetailcode op.

(Overgenomen van WebBaseEvent)
EventID

Hiermee haalt u de id op die is gekoppeld aan de gebeurtenis.

(Overgenomen van WebBaseEvent)
EventOccurrence

Hiermee wordt een teller opgehaald die het aantal keren aangeeft dat de gebeurtenis heeft plaatsgevonden.

(Overgenomen van WebBaseEvent)
EventSequence

Hiermee wordt het aantal keren opgehaald dat de gebeurtenis door de toepassing is gegenereerd.

(Overgenomen van WebBaseEvent)
EventSource

Hiermee haalt u het object op dat de gebeurtenis genereert.

(Overgenomen van WebBaseEvent)
EventTime

Hiermee wordt de tijd opgehaald waarop de gebeurtenis is gegenereerd.

(Overgenomen van WebBaseEvent)
EventTimeUtc

Hiermee wordt de tijd opgehaald waarop de gebeurtenis is gegenereerd.

(Overgenomen van WebBaseEvent)
Message

Hiermee haalt u het bericht op waarin de gebeurtenis wordt beschreven.

(Overgenomen van WebBaseEvent)
ProcessInformation

Hiermee wordt informatie opgehaald over het ASP.NET proces voor het hosten van toepassingen.

(Overgenomen van WebManagementEvent)

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
FormatCustomEventDetails(WebEventFormatter)

Biedt standaardopmaak van de gebeurtenisgegevens.

(Overgenomen van WebBaseEvent)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
IncrementPerfCounters()

Intern gebruikt om prestatiemeteritems te verhogen.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Raise()

Hiermee wordt een gebeurtenis gegenereerd door een geconfigureerde provider op de hoogte te stellen dat de gebeurtenis heeft plaatsgevonden.

(Overgenomen van WebBaseEvent)
ToString()

Hiermee worden gebeurtenisgegevens opgemaakt voor weergavedoeleinden.

(Overgenomen van WebBaseEvent)
ToString(Boolean, Boolean)

Hiermee worden gebeurtenisgegevens opgemaakt voor weergavedoeleinden.

(Overgenomen van WebBaseEvent)

Van toepassing op

Zie ook