WebApplicationInformation Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje informace přidružené k událostem stavu.
public ref class WebApplicationInformation sealed
public sealed class WebApplicationInformation
type WebApplicationInformation = class
Public NotInheritable Class WebApplicationInformation
- Dědičnost
-
WebApplicationInformation
Příklady
Následující příklad kódu má dvě části. První část je výňatek konfiguračního souboru, který umožňuje ASP.NET použít vlastní událost. Druhý ukazuje, jak vytvořit vlastní událost pomocí WebApplicationInformation třídy.
Ujistěte se, že je vaše vlastní událost vyvolána ve správný čas, tj. pokud by byla vyvolána ekvivalentní událost stavu systému, kterou nahradí.
<healthMonitoring
enabled="true" heartBeatInterval="0">
<eventMappings>
<add name="SampleApplicationInformation"
type="SamplesAspNet.SampleWebApplicationInformation, webapplicationinformation, Version=1.0.1585.27289, Culture=neutral, PublicKeyToken=3648e5c763a8239f, processorArchitecture=MSIL"/>
</eventMappings>
<rules>
<add name="Custom Application Information"
eventName="SampleApplicationInformation"
provider="EventLogProvider"
profile="Default"/>
</rules>
</healthMonitoring>
using System;
using System.Text;
using System.Web;
using System.Web.Management;
namespace SamplesAspNet
{
// Implements a custom WebBaseEvent that uses
// WebApplicationInformation.
public class SampleWebApplicationInformation :
WebBaseEvent
{
private StringBuilder eventInfo;
// Instantiate SampleWebGet
public SampleWebApplicationInformation(string msg,
object eventSource, int eventCode):
base(msg, eventSource, eventCode)
{
// Perform custom initialization.
eventInfo = new StringBuilder();
eventInfo.Append(string.Format(
"Event created at: {0}",
EventTime.ToString()));
}
// Raises the event.
public override void Raise()
{
// Perform custom processing.
eventInfo.Append(string.Format(
"Event raised at: {0}",
EventTime.ToString()));
// Raise the event.
base.Raise();
}
public string GetApplicationDomain()
{
// Get the name of the application domain.
return (string.Format(
"Application domain: {0}",
ApplicationInformation.ApplicationDomain));
}
public string GetApplicationPath()
{
// Get the name of the application path.
return (string.Format(
"Application path: {0}",
ApplicationInformation.ApplicationPath));
}
public string GetApplicationVirtualPath()
{
// Get the name of the application virtual path.
return (string.Format(
"Application virtual path: {0}",
ApplicationInformation.ApplicationVirtualPath));
}
public string GetApplicationMachineName()
{
// Get the name of the application machine name.
return (string.Format(
"Application machine name: {0}",
ApplicationInformation.MachineName));
}
public string GetApplicationTrustLevel()
{
// Get the name of the application trust level.
return (string.Format(
"Application trust level: {0}",
ApplicationInformation.TrustLevel));
}
//Formats Web request event information.
public override void FormatCustomEventDetails(
WebEventFormatter formatter)
{
base.FormatCustomEventDetails(formatter);
// Add custom data.
formatter.AppendLine("");
formatter.AppendLine(
"Custom Application Information:");
formatter.IndentationLevel += 1;
// Display the application information.
formatter.AppendLine(GetApplicationDomain());
formatter.AppendLine(GetApplicationPath());
formatter.AppendLine(GetApplicationVirtualPath());
formatter.AppendLine(GetApplicationMachineName());
formatter.AppendLine(GetApplicationTrustLevel());
formatter.IndentationLevel -= 1;
formatter.AppendLine(eventInfo.ToString());
}
}
}
Imports System.Text
Imports System.Web
Imports System.Web.Management
'Implements a custom WebBaseEvent that uses
' WebApplicationInformation.
Public Class SampleWebApplicationInformation
Inherits WebBaseEvent
Private eventInfo As StringBuilder
' Instantiate SampleWebGet
Public Sub New(ByVal msg As String, _
ByVal eventSource As Object, _
ByVal eventCode As Integer)
MyBase.New(msg, eventSource, eventCode)
' Perform custom initialization.
eventInfo = New StringBuilder()
eventInfo.Append(String.Format( _
"Event created at: {0}", EventTime.ToString()))
End Sub
' Raises the event.
Public Overrides Sub Raise()
' Perform custom processing.
eventInfo.Append(String.Format( _
"Event raised at: {0}", EventTime.ToString()))
' Raise the event.
MyBase.Raise()
End Sub
Public Function GetApplicationDomain() As String
' Get the name of the application domain.
Return String.Format( _
"Application domain: {0}", _
ApplicationInformation.ApplicationDomain)
End Function 'GetApplicationDomain
Public Function GetApplicationPath() As String
' Get the name of the application path.
Return String.Format( _
"Application path: {0}", _
ApplicationInformation.ApplicationPath())
End Function 'GetApplicationPath
Public Function GetApplicationVirtualPath() As String
' Get the name of the application virtual path.
Return String.Format( _
"Application virtual path: {0}", _
ApplicationInformation.ApplicationVirtualPath())
End Function 'GetApplicationVirtualPath
Public Function GetApplicationMachineName() As String
' Get the name of the application machine name.
Return String.Format( _
"Application machine name: {0}", _
ApplicationInformation.MachineName())
End Function 'GetApplicationMachineName
Public Function GetApplicationTrustLevel() As String
' Get the name of the application trust level.
Return String.Format( _
"Application trust level: {0}", _
ApplicationInformation.TrustLevel())
End Function 'GetApplicationTrustLevel
'Formats Web request event information.
Public Overrides Sub FormatCustomEventDetails( _
_
ByVal formatter As WebEventFormatter)
MyBase.FormatCustomEventDetails(formatter)
' Add custom data.
formatter.AppendLine( _
"Custom Application Information:")
formatter.IndentationLevel += 1
' Display the application information.
formatter.AppendLine(GetApplicationDomain())
formatter.AppendLine(GetApplicationPath())
formatter.AppendLine(GetApplicationVirtualPath())
formatter.AppendLine(GetApplicationMachineName())
formatter.AppendLine(GetApplicationTrustLevel())
formatter.IndentationLevel -= 1
formatter.AppendLine(eventInfo.ToString())
End Sub
End Class
Poznámky
monitorování stavu ASP.NET umožňuje provozním a provozním pracovníkům spravovat nasazené webové aplikace. Obor System.Web.Management názvů obsahuje typy událostí stavu zodpovědné za balení dat stavu aplikace a typů poskytovatelů zodpovědných za zpracování těchto dat. Obsahuje také podpůrné typy, které pomáhají při správě událostí stavu.
WebApplicationInformation Instance třídy obsahují informace získané pomocí libovolného typu odvozeného z WebManagementEvent typu.
Vaše aplikace potřebuje příslušná oprávnění pro přístup k chráněným informacím poskytovaných tímto typem.
Následuje výňatek konfiguračního souboru, který můžete použít k povolení ASP.NET k protokolování událostí chyb obsahujících informace o aplikaci.
<healthMonitoring
enabled="true" heartBeatInterval="0">
<rules>
<add
name="All Errors Default"
eventName="All Errors"
provider="EventLogProvider"
profile="Default"
minInterval="00:01:00" />
</rules>
</healthMonitoring>
Poznámka
Ve většině případů budete moct používat typy monitorování stavu ASP.NET jako implementované a budete řídit systém monitorování stavu zadáním hodnot v healthMonitoring
části konfigurace. Můžete také odvozovat z typů monitorování stavu a vytvořit vlastní události a poskytovatele. Příklad vytvoření vlastní třídy událostí najdete v příkladu uvedeném v tomto tématu.
Vlastnosti
ApplicationDomain |
Získá aktuální název domény aplikace. |
ApplicationPath |
Získá fyzickou cestu aplikace. |
ApplicationVirtualPath |
Získá logickou cestu aplikace. |
MachineName |
Získá název počítače aplikace. |
TrustLevel |
Získá úroveň důvěryhodnosti aplikace. |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FormatToString(WebEventFormatter) |
Naformátuje informace o aplikaci. |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
ToString() |
Formátuje informace o událostech pro účely zobrazení. |