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
ASP.NET monitorování stavu 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.
Instance třídy obsahují informace, které jsou získány WebApplicationInformation pomocí některého z typů odvozených z WebManagementEvent typu.
Aplikace potřebuje příslušná oprávnění pro přístup k chráněným informacím poskytnutým tímto typem.
Následuje výňatek konfiguračního souboru, který můžete použít k povolení ASP.NET protokolování chybových událostí 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>
Note
Ve většině případů budete moct používat typy monitorování stavu ASP.NET, které jsou implementované, a systém monitorování stavu budete řídit zadáním hodnot v části konfigurace healthMonitoring. Můžete také odvodit z typů monitorování stavu a vytvořit vlastní události a zprostředkovatele. Příklad vytvoření vlastní třídy událostí najdete v příkladu uvedeném v tomto tématu.
Vlastnosti
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven 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() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Formátuje informace o událostech pro účely zobrazení. |