WebSuccessAuditEvent Klas

Definitie

public ref class WebSuccessAuditEvent : System::Web::Management::WebAuditEvent

public class WebSuccessAuditEvent : System.Web.Management.WebAuditEvent

type WebSuccessAuditEvent = class
    inherit WebAuditEvent

Public Class WebSuccessAuditEvent
Inherits WebAuditEvent

Overname

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent

Afgeleid

System.Web.Management.WebAuthenticationSuccessAuditEvent

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u kunt afleiden van de WebSuccessAuditEvent klasse om een aangepaste auditgebeurtenis te maken.

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

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

        // Invoked in case of events identified only by their event code.
        public SampleWebSuccessAuditEvent(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 SampleWebSuccessAuditEvent(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 SampleWebSuccessAuditEvent.
        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 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(
                "******** SampleWebSuccessAuditEvent 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(
                "******** SampleWebSuccessAuditEvent End ********");

            formatter.IndentationLevel -= 1;
        }
    }
}

Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebSuccessAuditEvent class. 

Public Class SampleWebSuccessAuditEvent
    Inherits System.Web.Management.WebSuccessAuditEvent
    Private customCreatedMsg, customRaisedMsg As String
    
    
    
    ' Invoked in case of 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.
        customCreatedMsg = String.Format("Event created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub
    
    
    ' Invoked in case of events identified by their event code.and 
    ' event detailed code.
    Public Sub New(ByVal msg As String, ByVal eventSource As Object, _
    ByVal eventCode As Integer, ByVal detailedCode As Integer)
        MyBase.New(msg, EventSource, eventCode, detailedCode)
        ' Perform custom initialization.
        customCreatedMsg = String.Format("Event created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub
    
    
    
    ' Raises the SampleWebSuccessAuditEvent.
    Public Overrides Sub Raise() 
        ' Perform custom processing.
        customRaisedMsg = String.Format("Event raised at: {0}", _
        DateTime.Now.TimeOfDay.ToString())
        
        ' Raise the event.
        WebBaseEvent.Raise(Me)
    
    End Sub
    
    
    ' Obtains the current thread information.
    Public Function GetRequestInformation() As WebRequestInformation 
        ' No customization allowed.
        Return RequestInformation
    
    End Function 'GetRequestInformation
    
    
    'Formats Web request event information.
    'This method is invoked indirectly by the provider using one of the
    'overloaded ToString methods.
    Public Overrides Sub FormatCustomEventDetails(ByVal formatter _
    As WebEventFormatter)
        MyBase.FormatCustomEventDetails(formatter)

        ' Add custom data.
        formatter.AppendLine("")

        formatter.IndentationLevel += 1
        formatter.AppendLine("**SampleWebSuccessAuditEvent 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("** SampleWebSuccessAuditEvent End **")

        formatter.IndentationLevel -= 1

    End Sub
End Class

Het volgende voorbeeld is een fragment van het configuratiebestand waarmee ASP.NET statuscontrole de gebeurtenis kan gebruiken.

<healthMonitoring
..enabled="true"
..heartBeatInterval="0">
  <providers>
    <add name="EventLogProvider"
    type="System.Web.Management.EventLogWebEventProvider,
    System.Web,Version=2.0.3600.0,Culture=neutral,
    PublicKeyToken=b03f5f7f11d50a3a"/>
  </providers>
  <eventMappings>
    <add  name="SampleWebSuccessAuditEvent"
      type="SamplesAspNet.SampleWebSuccessAuditEvent,
      websuccessauditevent,Version=1.0.1663.31140,
      Culture=neutral,
      PublicKeyToken=0d1fa0f69d94de96,
      processorArchitecture=MSIL"/>
  </eventMappings>
  <rules>
    <add name="Custom Failure Audit Default"
      eventName=" SampleWebFailureAuditEvent "
      provider="EventLogProvider"
      profile="Default"/>
  </rules>
</healthMonitoring>

Opmerkingen

ASP.NET statuscontrole maakt het productie- en operationele personeel mogelijk om geïmplementeerde webtoepassingen te beheren. De System.Web.Management naamruimte bevat de statusgebeurtenistypen die verantwoordelijk zijn voor het verpakken van statusgegevens van toepassingen en de providertypen die verantwoordelijk zijn voor het verwerken van deze gegevens. Het bevat ook ondersteunende typen die u helpen tijdens het beheer van statusevenementen.

De WebSuccessAuditEvent klasse wordt gebruikt wanneer een geslaagde beveiligingsbewerking plaatsvindt. Een voorbeeld hiervan is een geslaagde URL-autorisatie voor een webaanvraag.

In de volgende lijst worden de functies beschreven waarvoor gebeurtenissen van het type WebSuccessAuditEvent worden gegenereerd door ASP.NET:

• Bestandsautorisatie. Geslaagde voorwaarden worden gecontroleerd. Bestandsautorisatie wordt alleen geprobeerd door ASP.NET wanneer een Windows-identiteit is gekoppeld aan de aanvraag. De gerelateerde controlecode voor gebeurtenissen is AuditFileAuthorizationSuccess.

• URL-autorisatie. Het geeft toegang aan van een URL-resource waarvoor autorisatie wordt verleend. Geslaagde voorwaarden worden gecontroleerd. De gerelateerde controlecode voor gebeurtenissen is AuditUrlAuthorizationSuccess.

• Andere beveiligingsvoorwaarden. Hier volgt een lijst met de gerelateerde gebeurteniscodes:

  • AuditFormsAuthenticationSuccess

  • AuditMembershipAuthenticationSuccess

Wanneer er een WebSuccessAuditEvent wordt gegenereerd, worden de gerelateerde prestatiemeteritems voor geslaagde controle verhoogd ASP.NET de gerelateerde prestatiemeteritems verhoogd en wordt vervolgens de configuratie healthMonitoring gecontroleerd om te bepalen of providers zich abonneren op de gebeurtenis. Als providers zich abonneren op de gebeurtenis, ASP.NET de gebeurtenis naar hen verzendt voor verwerking.

Omdat geslaagde controles een verwachte voorwaarde vertegenwoordigen, wilt u zich mogelijk niet abonneren op deze voorwaarden. U kunt zich hierop abonneren om toegangscontrole voor de site te bieden.

Zie ook

• WebAuditEvent
• WebFailureAuditEvent
• WebEventCodes
• Overzicht van ASP.NET statuscontrole