WebBaseErrorEvent Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Fungerar som basklass för alla felhändelser för hälsoövervakning.
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
- Arv
- Härledda
Exempel
I följande kodexempel finns två delar. Den första är ett utdrag av en konfigurationsfil som gör att ASP.NET hälsoövervakning kan använda en händelse som härleds från klassen WebBaseErrorEvent. Den andra visar hur du härleder från WebBaseErrorEvent klassen för att skapa den anpassade händelsen.
<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>
Följande kod visar hur du härleder från WebBaseErrorEvent klassen för att skapa en anpassad händelse.
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
Kommentarer
ASP.NET hälsoövervakning gör det möjligt för produktions- och driftpersonal att hantera distribuerade webbprogram. Namnområdet System.Web.Management innehåller de hälsohändelsetyper som ansvarar för att paketera programhälsostatusdata och de leverantörstyper som ansvarar för bearbetning av dessa data. Den innehåller också stödtyper som hjälper till vid hantering av hälsohändelser.
Klassen WebBaseErrorEvent är basklassen för hälsoövervakningshändelser som representerar feltillstånd. ASP.NET använder WebBaseErrorEvent och dess härledda typer för att ange feltillstånd under livslängden för ett webbprogram.
Note
I de flesta fall kommer du att kunna använda ASP.NET hälsoövervakningstyper som implementerats och du kommer att kontrollera hälsoövervakningssystemet genom att ange värden i konfigurationsavsnittet healthMonitoring. Du kan också härleda från hälsoövervakningstyperna för att skapa egna anpassade händelser och leverantörer. Ett exempel på härledning från WebBaseErrorEvent klassen finns i exemplet i det här avsnittet.
Konstruktorer
| Name | Description |
|---|---|
| WebBaseErrorEvent(String, Object, Int32, Exception) |
Initierar en ny instans av WebBaseErrorEvent klassen. |
| WebBaseErrorEvent(String, Object, Int32, Int32, Exception) |
Initierar en ny instans av WebBaseErrorEvent klassen. |
Egenskaper
| Name | Description |
|---|---|
| ErrorException |
Hämtar associerad Exception med felet. |
| EventCode |
Hämtar det kodvärde som är associerat med händelsen. (Ärvd från WebBaseEvent) |
| EventDetailCode |
Hämtar händelseinformationskoden. (Ärvd från WebBaseEvent) |
| EventID |
Hämtar identifieraren som är associerad med händelsen. (Ärvd från WebBaseEvent) |
| EventOccurrence |
Hämtar en räknare som representerar antalet gånger händelsen har inträffat. (Ärvd från WebBaseEvent) |
| EventSequence |
Hämtar antalet gånger som händelsen har skapats av programmet. (Ärvd från WebBaseEvent) |
| EventSource |
Hämtar objektet som genererar händelsen. (Ärvd från WebBaseEvent) |
| EventTime |
Hämtar den tid då händelsen skapades. (Ärvd från WebBaseEvent) |
| EventTimeUtc |
Hämtar den tid då händelsen skapades. (Ärvd från WebBaseEvent) |
| Message |
Hämtar meddelandet som beskriver händelsen. (Ärvd från WebBaseEvent) |
| ProcessInformation |
Hämtar information om ASP.NET programvärdprocess. (Ärvd från WebManagementEvent) |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FormatCustomEventDetails(WebEventFormatter) |
Tillhandahåller standardformatering av händelseinformationen. (Ärvd från WebBaseEvent) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| IncrementPerfCounters() |
Ökar prestandarelaterade räknare för händelsefel. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| Raise() |
Genererar en händelse genom att meddela alla konfigurerade leverantörer att händelsen har inträffat. (Ärvd från WebBaseEvent) |
| ToString() |
Formaterar händelseinformation i visningssyfte. (Ärvd från WebBaseEvent) |
| ToString(Boolean, Boolean) |
Formaterar händelseinformation i visningssyfte. (Ärvd från WebBaseEvent) |