Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Classe WebFailureAuditEvent

Classe WebFailureAuditEvent

Fornisce informazioni sugli errori di sicurezza.

Spazio dei nomi: System.Web.Management
Assembly: System.Web (in system.web.dll)

public class WebFailureAuditEvent : WebAuditEvent
public class WebFailureAuditEvent extends WebAuditEvent
public class WebFailureAuditEvent extends WebAuditEvent
Non applicabile.

Il monitoraggio dello stato di ASP.NET consente al personale responsabile dell'ambiente di produzione e delle operazioni di gestire applicazioni Web distribuite. Lo spazio dei nomi System.Web.Management contiene i tipi di eventi relativi allo stato responsabili della creazione di package dei dati di stato delle applicazioni e i tipi di provider responsabili dell'elaborazione di tali dati. Include inoltre tipi di supporto che si rivelano utili nella gestione di eventi relativi allo stato.

La classe WebFailureAuditEvent viene utilizzata quando un'operazione relativa alla sicurezza ha esito negativo. Un esempio è rappresentato da un'autorizzazione URL con esito negativo per una richiesta Web.

Per impostazione predefinita, ASP.NET è configurato in modo da generare l'evento WebFailureAuditEvent per le funzionalità riportate di seguito:

Quando viene generato un evento WebFailureAuditEvent, il monitoraggio dello stato di ASP.NET incrementa il contatore delle prestazioni Audit Failure Events Raised correlato e quindi controlla la sezione di configurazione di healthMonitoring per determinare l'eventuale sottoscrizione dell'evento da parte dei provider. In caso di sottoscrizione dell'evento da parte dei provider, ASP.NET invia l'evento ai provider per l'elaborazione.

NotaNota:

Per visualizzare il contatore delle prestazioni Audit Failure Events Raised in Monitor di sistema (PerfMon), nella finestra Aggiungi contatori, selezionare ASP.NET dall'elenco a discesa Oggetto prestazione, selezionare il contatore delle prestazioni Audit Failure Events Raised e quindi scegliere Aggiungi. Per ulteriori informazioni, vedere Using the System Monitor (PerfMon) with ASP.NET Applications nella documentazione di IIS in MSDN (informazioni in lingua inglese).

NotaNota:

Nella maggior parte dei casi, è possibile utilizzare i tipi di monitoraggio dello stato di ASP.NET così come sono implementati e quindi controllare il sistema di monitoraggio dello stato specificando i valori appropriati nella sezione di configurazione healthMonitoring. È inoltre possibile creare eventi e provider personalizzati mediante la derivazione dai tipi di monitoraggio dello stato. Per un esempio di derivazione dalla classe WebFailureAuditEvent, vedere la sezione Esempio.

Note per gli eredi: In occasione della formattazione delle informazioni relative a eventi personalizzati per la visualizzazione, eseguire l'override del metodo FormatCustomEventDetails anziché del metodo ToString. Sarà così possibile evitare la sovrascrittura o l'alterazione di informazioni di sistema riservate.

Nell'esempio di codice riportato di seguito viene illustrato come creare un evento di controllo personalizzato mediante la derivazione dalla classe WebFailureAuditEvent.


using System;
using System.Text;
using System.Web;
using System.Web.Management;

namespace SamplesAspNet
{
    // Implements a custom WebFailureAuditEvent class. 
    public class SampleWebFailureAuditEvent : 
        System.Web.Management.WebFailureAuditEvent
    {
        private string customCreatedMsg, customRaisedMsg;


        // Invoked in case of events identified only by their event code.
        public SampleWebFailureAuditEvent(string msg, object eventSource,
            int eventCode):
        base(msg, eventSource, eventCode)
        {
            // Perform custom initialization.
            customCreatedMsg =
                string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }


        // Invoked in case of events identified by their event code and 
        // event detailed code.
        public SampleWebFailureAuditEvent(string msg, object eventSource,
            int eventCode, int detailedCode):
        base(msg, eventSource, eventCode, detailedCode)
        {
            // Perform custom initialization.
            customCreatedMsg =
            string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }



        // Raises the SampleWebFailureAuditEvent.
        public override void Raise()
        {
            // Perform custom processing.
            customRaisedMsg =
                string.Format("Event raised at: {0}", 
                DateTime.Now.TimeOfDay.ToString());

            // Raise the event.
            WebBaseEvent.Raise(this);
        }


        // Obtains the current thread information.
        public WebRequestInformation GetRequestInformation()
        {
            // No customization is allowed.
            return RequestInformation;
        }


        //Formats Web request event information.
        //This method is invoked indirectly by the provider 
        //using one of the overloaded ToString methods.
        public override void FormatCustomEventDetails(WebEventFormatter formatter)
        {
            base.FormatCustomEventDetails(formatter);

            // Add custom data.
            formatter.AppendLine("");

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "******** SampleWebFailureAuditEvent Start ********");
            formatter.AppendLine(string.Format("Request path: {0}",
                RequestInformation.RequestPath));
            formatter.AppendLine(string.Format("Request Url: {0}",
                RequestInformation.RequestUrl));

            // Display custom event timing.
            formatter.AppendLine(customCreatedMsg);
            formatter.AppendLine(customRaisedMsg);

            formatter.AppendLine(
                "******** SampleWebFailureAuditEvent End ********");

            formatter.IndentationLevel -= 1;

        }
    }

}

Nel frammento di configurazione riportato di seguito viene illustrato come abilitare l'utilizzo di WebFailureAuditEvent in ASP.NET.

<healthMonitoring 
enabled="true"
heartBeatInterval="0"> 
<providers>
<eventMappings>
<rules>
</healthMonitoring>

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2015 Microsoft