WebErrorEvent Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Informationen zu systemischen Fehlern bereit.
public ref class WebErrorEvent : System::Web::Management::WebBaseErrorEvent
public class WebErrorEvent : System.Web.Management.WebBaseErrorEvent
type WebErrorEvent = class
inherit WebBaseErrorEvent
Public Class WebErrorEvent
Inherits WebBaseErrorEvent
- Vererbung
Beispiele
Das folgende Codebeispiel zeigt, wie sie von der WebErrorEvent Klasse abgeleitet werden, um ein benutzerdefiniertes Ereignis zu erstellen.
Außerdem wird ein Auszug der Konfigurationsdatei angezeigt, mit der ASP.NET dieses benutzerdefinierte Ereignis verwenden kann.
<healthMonitoring
enabled="true" heartBeatInterval="0">
<eventMappings>
<add name="SampleWebErrorEvent" type="SamplesAspNet.SampleWebErrorEvent,weberrorevent,Version=1.0.1573.21549, Culture=neutral, PublicKeyToken=2a0b23915ac7352b, processorArchitecture=MSIL"/>
</eventMappings>
<profiles>
<add name="Custom"
minInstances="1"
maxLimit="Infinite"
minInterval="00:00:00" />
</profiles>
<rules>
<clear />
<add name="Custom Web Error Event"
eventName="SampleWebErrorEvent"
provider="EventLogProvider"
profile="Custom" />
</rules>
</healthMonitoring>
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
Hinweise
ASP.NET Integritätsüberwachung ermöglicht es Produktions- und Betriebsmitarbeitern, bereitgestellte Webanwendungen zu verwalten. Der System.Web.Management Namespace enthält die Gesundheitsereignistypen, die für das Verpacken von Anwendungsintegritätsstatusdaten und die Anbieter-Typen für die Verarbeitung dieser Daten verantwortlich sind. Es enthält auch unterstützende Typen, die bei der Verwaltung von Integritätsereignissen helfen.
Die WebErrorEvent Enthält Informationen zu Fehlern, die durch Probleme mit Konfigurations- oder Anwendungscode verursacht werden. Ein Beispiel ist der fehler, der von ASP.NET ausgegeben wird, wenn ein Fehler auf einer Seite gefunden wird.
Note
In den meisten Fällen können Sie die ASP.NET Integritätsüberwachungstypen wie implementiert verwenden, und Sie steuern das Integritätsüberwachungssystem, indem Sie Werte im Konfigurationsabschnitt healthMonitoring angeben. Sie können auch von den Integritätsüberwachungstypen abgeleitet werden, um eigene benutzerdefinierte Ereignisse und Anbieter zu erstellen. Ein Beispiel für die Ableitung von der WebErrorEvent Klasse finden Sie im beispiel in diesem Thema.
Konstruktoren
| Name | Beschreibung |
|---|---|
| WebErrorEvent(String, Object, Int32, Exception) |
Initialisiert die Klasse mithilfe der WebErrorEvent angegebenen Parameter. |
| WebErrorEvent(String, Object, Int32, Int32, Exception) |
Initialisiert eine neue Instanz der Klasse mithilfe der WebErrorEvent angegebenen Parameter. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ErrorException |
Ruft den Exception zugeordneten Fehler ab. (Geerbt von WebBaseErrorEvent) |
| EventCode |
Ruft den Codewert ab, der dem Ereignis zugeordnet ist. (Geerbt von WebBaseEvent) |
| EventDetailCode |
Ruft den Ereignisdetailscode ab. (Geerbt von WebBaseEvent) |
| EventID |
Ruft den Bezeichner ab, der dem Ereignis zugeordnet ist. (Geerbt von WebBaseEvent) |
| EventOccurrence |
Ruft einen Zähler ab, der die Anzahl der Vorkommen des Ereignisses darstellt. (Geerbt von WebBaseEvent) |
| EventSequence |
Ruft ab, wie oft das Ereignis von der Anwendung ausgelöst wurde. (Geerbt von WebBaseEvent) |
| EventSource |
Ruft das Objekt ab, das das Ereignis auslöst. (Geerbt von WebBaseEvent) |
| EventTime |
Ruft die Zeit ab, zu der das Ereignis ausgelöst wurde. (Geerbt von WebBaseEvent) |
| EventTimeUtc |
Ruft die Zeit ab, zu der das Ereignis ausgelöst wurde. (Geerbt von WebBaseEvent) |
| Message |
Ruft die Nachricht ab, die das Ereignis beschreibt. (Geerbt von WebBaseEvent) |
| ProcessInformation |
Ruft Informationen zum ASP.NET Anwendungshostingprozesses ab. (Geerbt von WebManagementEvent) |
| RequestInformation |
Ruft die Anwendungsanforderungsinformationen ab. |
| ThreadInformation |
Ruft die Anwendungsthreadinformationen ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FormatCustomEventDetails(WebEventFormatter) |
Stellt die Standardformatierung der Ereignisinformationen bereit. (Geerbt von WebBaseEvent) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IncrementPerfCounters() |
Wird intern verwendet, um Leistungsindikatoren zu erhöhen. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Raise() |
Löst ein Ereignis aus, indem alle konfigurierten Anbieter benachrichtigt werden, dass das Ereignis aufgetreten ist. (Geerbt von WebBaseEvent) |
| ToString() |
Formatiert Ereignisinformationen für Anzeigezwecke. (Geerbt von WebBaseEvent) |
| ToString(Boolean, Boolean) |
Formatiert Ereignisinformationen für Anzeigezwecke. (Geerbt von WebBaseEvent) |