WebRequestInformation Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiera informacje o bieżącym żądaniu internetowym.
public ref class WebRequestInformation sealed
public sealed class WebRequestInformation
type WebRequestInformation = class
Public NotInheritable Class WebRequestInformation
- Dziedziczenie
-
WebRequestInformation
Przykłady
Poniższy przykład kodu przedstawia sposób implementowania zdarzenia niestandardowego WebRequestInformation , które używa typu.
Pokazano również fragment pliku konfiguracji, który umożliwia ASP.NET korzystanie z tego zdarzenia niestandardowego.
Upewnij się, że zdarzenie niestandardowe jest zgłaszane w odpowiednim czasie, czyli gdy zostanie zgłoszone równoważne zdarzenie kondycji systemu, które zastąpi.
<healthMonitoring
heartBeatInterval="0" enabled="true">
<profiles>
<add name="Custom"
minInstances="1"
maxLimit="Infinite"
minInterval="00:00:00" />
</profiles>
<eventMappings>
<add
name="SampleWebRequestInformation"
type="SamplesAspNet.SampleWebRequestInformation,webrequestinformation,Version=1.0.1782.28745, Culture=neutral, PublicKeyToken=79955d9b8521c250,processorArchitecture=MSIL" />
</eventMappings>
<rules>
<add name="Custom Web Request Info Event"
eventName="SampleWebRequestInformation"
provider="EventLogProvider"
profile="Custom" />
</rules>
</healthMonitoring>
using System;
using System.Text;
using System.Web;
using System.Web.Management;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace SamplesAspNet
{
// Implements a custom WebRequestEvent that uses
// WebRequestInformation.
public class SampleWebRequestInformation :
WebRequestEvent
{
private StringBuilder eventInfo;
// Instantiate events identified
// only by their event code.
public SampleWebRequestInformation(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()));
}
// Instantiate events identified by
// their event code.and related
// event detailed code.
public SampleWebRequestInformation(string msg,
object eventSource, int eventCode,
int eventDetailCode)
:
base(msg, eventSource,
eventCode, eventDetailCode)
{
// 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();
}
// Get the request path.
public string GetRequestPath()
{
// Get the request path.
return (string.Format(
"Request path: {0}",
RequestInformation.RequestPath));
}
// Get the request URL.
public string GetRequestUrl()
{
// Get the request URL.
return (string.Format(
"Request URL: {0}",
RequestInformation.RequestUrl));
}
// Get the request user host address.
public string GetRequestUserHostAdddress()
{
// Get the request user host address.
return (string.Format(
"Request user host address: {0}",
RequestInformation.UserHostAddress));
}
// Get the request principal.
public string GetRequestPrincipal()
{
// Get the request principal.
return (string.Format(
"Request principal name: {0}",
RequestInformation.Principal.Identity.Name));
}
// Formats Web request event information.
public override void FormatCustomEventDetails(
WebEventFormatter formatter)
{
// Add custom data.
formatter.AppendLine("");
formatter.AppendLine(
"Custom Request Information:");
formatter.IndentationLevel += 1;
// Display the request information obtained
// using the WebRequestInformation object.
formatter.AppendLine(GetRequestPath());
formatter.AppendLine(GetRequestUrl());
formatter.AppendLine(GetRequestUserHostAdddress());
formatter.AppendLine(GetRequestPrincipal());
formatter.IndentationLevel -= 1;
formatter.AppendLine(eventInfo.ToString());
}
}
}
Imports System.Text
Imports System.Web
Imports System.Web.Management
Imports System.Web.UI
Imports System.Web.UI.WebControls
' Implements a custom WebRequestEvent that uses
' WebRequestInformation.
Public Class SampleWebRequestInformation
Inherits WebRequestEvent
Private eventInfo As StringBuilder
' Instantiate events identified
' only by their event code.
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
' Instantiate 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 eventDetailCode As Integer)
MyBase.New(msg, eventSource, _
eventCode, eventDetailCode)
' 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
' Get the request path.
Public Function GetRequestPath() As String
' Get the request path.
Return String.Format( _
"Request path: {0}", RequestInformation.RequestPath)
End Function 'GetRequestPath
' Get the request URL.
Public Function GetRequestUrl() As String
' Get the request URL.
Return String.Format("Request URL: {0}", _
RequestInformation.RequestUrl)
End Function 'GetRequestUrl
' Get the request user host address.
Public Function GetRequestUserHostAdddress() As String
' Get the request user host address.
Return String.Format( _
"Request user host address: {0}", _
RequestInformation.UserHostAddress)
End Function 'GetRequestUserHostAdddress
' Get the request principal.
Public Function GetRequestPrincipal() As String
' Get the request principal.
Return String.Format( _
"Request principal name: {0}", _
RequestInformation.Principal.Identity.Name)
End Function 'GetRequestPrincipal
' Formats Web request event information.
Public Overrides Sub FormatCustomEventDetails( _
ByVal formatter As WebEventFormatter)
' Add custom data.
formatter.AppendLine("")
formatter.AppendLine("Custom Request Information:")
formatter.IndentationLevel += 1
' Display the request information obtained
' using the WebRequestInformation object.
formatter.AppendLine(GetRequestPath())
formatter.AppendLine(GetRequestUrl())
formatter.AppendLine(GetRequestUserHostAdddress())
formatter.AppendLine(GetRequestPrincipal())
formatter.IndentationLevel -= 1
formatter.AppendLine(eventInfo.ToString())
End Sub
End Class
Uwagi
ASP.NET monitorowanie kondycji umożliwia pracownikom produkcyjnym i operacyjnym zarządzanie wdrożonych aplikacji internetowych. System.Web.Management Przestrzeń nazw zawiera typy zdarzeń kondycji odpowiedzialnych za pakowanie danych o stanie kondycji aplikacji i typów dostawców odpowiedzialnych za przetwarzanie tych danych. Zawiera również typy pomocnicze, które ułatwiają zarządzanie zdarzeniami kondycji.
WebRequestInformation Wystąpienia klasy zawierają informacje uzyskane przy użyciu WebRequestEventtypów , WebAuditEvent, WebErrorEventlub WebRequestErrorEvent .
Aplikacja potrzebuje odpowiednich uprawnień, aby uzyskać dostęp do chronionych informacji dostarczonych przez ten typ.
Uwaga
W większości przypadków będzie można użyć ASP.NET typów monitorowania kondycji zgodnie z implementacją i będziesz kontrolować system monitorowania kondycji, określając wartości w healthMonitoring
sekcji konfiguracji. Możesz również pochodzić z typów monitorowania kondycji, aby utworzyć własne niestandardowe zdarzenia i dostawców. Przykład tworzenia niestandardowej klasy zdarzeń można znaleźć w przykładzie podanym w tym temacie.
Właściwości
Principal |
Pobiera wystąpienie podmiotu zabezpieczeń kodu zarządzanego skojarzonego z żądaniem sieci Web. |
RequestPath |
Pobiera ścieżkę fizyczną żądania internetowego. |
RequestUrl |
Pobiera ścieżkę logiczną żądania. |
ThreadAccountName |
Pobiera ciąg reprezentujący nazwę logowania użytkownika systemu Windows w jego imieniu, w którym jest uruchamiany kod. |
UserHostAddress |
Pobiera adres hosta użytkownika. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
FormatToString(WebEventFormatter) |
Formatuje informacje o żądaniu internetowym. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |