WebRequestInformation Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce informazioni relative alla richiesta Web corrente.
public ref class WebRequestInformation sealed
public sealed class WebRequestInformation
type WebRequestInformation = class
Public NotInheritable Class WebRequestInformation
- Ereditarietà
-
WebRequestInformation
Esempio
Nell'esempio di codice seguente viene illustrato come implementare un evento personalizzato che usa il WebRequestInformation tipo.
Viene anche mostrato un estratto del file di configurazione che consente ASP.NET di usare questo evento personalizzato.
Assicurarsi che l'evento personalizzato venga generato al momento appropriato, ovvero quando verrà generato l'evento di integrità del sistema equivalente che sostituisce.
<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
Commenti
ASP.NET monitoraggio dell'integrità consente al personale di produzione e operazioni di gestire le applicazioni Web distribuite. Lo System.Web.Management spazio dei nomi contiene i tipi di evento di integrità responsabili della creazione di pacchetti di dati relativi allo stato dell'integrità dell'applicazione e i tipi di provider responsabili dell'elaborazione di questi dati. Contiene anche tipi di supporto che consentono durante la gestione degli eventi di integrità.
Le istanze della WebRequestInformation classe contengono informazioni ottenute usando i WebRequestEventtipi , , WebErrorEventWebAuditEvento WebRequestErrorEvent .
L'applicazione deve disporre delle autorizzazioni appropriate per accedere alle informazioni protette fornite da questo tipo.
Nota
Nella maggior parte dei casi sarà possibile usare i tipi di monitoraggio dell'integrità ASP.NET come implementato e si controlla il sistema di monitoraggio dell'integrità specificando i valori nella healthMonitoring
sezione di configurazione. È anche possibile derivare dai tipi di monitoraggio dell'integrità per creare eventi e provider personalizzati. Per un esempio di creazione di una classe di evento personalizzata, vedere l'esempio fornito in questo argomento.
Proprietà
Principal |
Ottiene l'istanza dell'oggetto Principal in codice gestito associato alla richiesta Web. |
RequestPath |
Ottiene il percorso fisico della richiesta Web. |
RequestUrl |
Ottiene il percorso logico della richiesta Web. |
ThreadAccountName |
Ottiene una stringa che rappresenta il nome di accesso a Windows dell'utente per conto del quale viene eseguito il codice. |
UserHostAddress |
Ottiene l'indirizzo dell'host dell'utente. |
Metodi
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
FormatToString(WebEventFormatter) |
Formatta le informazioni relative alle richieste Web. |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |