WebBaseErrorEvent Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sirve de clase base para todos los eventos de error de supervisión de estado.
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
- Herencia
- Derivado
Ejemplos
El ejemplo de código siguiente tiene dos partes. El primero es un extracto de un archivo de configuración que permite ASP.NET supervisión de estado usar un evento derivado de la WebBaseErrorEvent clase . En el segundo se muestra cómo derivar de la WebBaseErrorEvent clase para crear el 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="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>
En el código siguiente se muestra cómo derivar de la WebBaseErrorEvent clase para crear un evento personalizado.
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
Comentarios
ASP.NET supervisión de estado permite al personal de producción y de operaciones administrar las aplicaciones web implementadas. El System.Web.Management espacio de nombres contiene los tipos de eventos de mantenimiento responsables de empaquetar los datos de estado de mantenimiento de la aplicación y los tipos de proveedor responsables de procesar estos datos. También contiene tipos auxiliares que ayudan durante la administración de eventos de mantenimiento.
La WebBaseErrorEvent clase es la clase base para los eventos de supervisión de estado que representan condiciones de error. ASP.NET usa WebBaseErrorEvent y sus tipos derivados para indicar condiciones de error durante la vigencia de una aplicación web.
Nota
En la mayoría de los casos, podrá usar los tipos de supervisión de estado ASP.NET tal como se implementa y controlará el sistema de supervisión de estado especificando valores en la healthMonitoring
sección de configuración. También puede derivar de los tipos de supervisión de estado para crear sus propios eventos y proveedores personalizados. Para obtener un ejemplo de derivación de la WebBaseErrorEvent clase , vea el ejemplo proporcionado en este tema.
Constructores
WebBaseErrorEvent(String, Object, Int32, Exception) |
Inicializa una nueva instancia de la clase WebBaseErrorEvent. |
WebBaseErrorEvent(String, Object, Int32, Int32, Exception) |
Inicializa una nueva instancia de la clase WebBaseErrorEvent. |
Propiedades
ErrorException |
Obtiene la excepción Exception asociada al error. |
EventCode |
Obtiene el valor de código asociado al evento. (Heredado de WebBaseEvent) |
EventDetailCode |
Obtiene el código de detalle de evento. (Heredado de WebBaseEvent) |
EventID |
Obtiene el identificador asociado al evento. (Heredado de WebBaseEvent) |
EventOccurrence |
Obtiene un contador que representa el número de veces que se ha producido el evento. (Heredado de WebBaseEvent) |
EventSequence |
Obtiene el número de veces que la aplicación ha provocado el evento. (Heredado de WebBaseEvent) |
EventSource |
Obtiene el objeto que provoca el evento. (Heredado de WebBaseEvent) |
EventTime |
Obtiene la hora a la que se produjo el evento. (Heredado de WebBaseEvent) |
EventTimeUtc |
Obtiene la hora a la que se produjo el evento. (Heredado de WebBaseEvent) |
Message |
Obtiene el mensaje que describe el evento. (Heredado de WebBaseEvent) |
ProcessInformation |
Obtiene información sobre el proceso de hospedaje de aplicaciones ASP.NET. (Heredado de WebManagementEvent) |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
FormatCustomEventDetails(WebEventFormatter) |
Da un formato estándar a la información de eventos. (Heredado de WebBaseEvent) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
IncrementPerfCounters() |
Incrementa los contadores de rendimiento de los errores de eventos. |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
Raise() |
Provoca un evento mediante la notificación a cualquier proveedor configurado de que el evento se ha producido. (Heredado de WebBaseEvent) |
ToString() |
Aplica formato a información de evento para su presentación. (Heredado de WebBaseEvent) |
ToString(Boolean, Boolean) |
Aplica formato a información de evento para su presentación. (Heredado de WebBaseEvent) |