WebSuccessAuditEvent Sınıf

Tanım

Ad Alanı:

System.Web.Management

Bütünleştirilmiş Kod:

System.Web.dll

Başarılı güvenlik olayları hakkında bilgi sağlar.

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

Devralma

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent

Türetilmiş

System.Web.Management.WebAuthenticationSuccessAuditEvent

Örnekler

Aşağıdaki kod örneği, özel bir denetim olayı oluşturmak için sınıfından WebSuccessAuditEvent türetme işlemini gösterir.

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

Aşağıdaki örnek, ASP.NET sistem durumu izlemesinin olayı kullanmasını sağlayan yapılandırma dosyasının bir alıntısıdır.

<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>  

Açıklamalar

ASP.NET sistem durumu izleme, üretim ve operasyon personelinin dağıtılan Web uygulamalarını yönetmesine olanak tanır. Ad alanı, System.Web.Management uygulama sistem durumu verilerini paketlemeden sorumlu sistem durumu olay türlerini ve bu verileri işlemeden sorumlu sağlayıcı türlerini içerir. Ayrıca, sistem durumu olaylarının yönetimi sırasında yardımcı olan destekleyici türler de içerir.

WebSuccessAuditEvent sınıfı, güvenlikle ilgili başarılı bir işlem gerçekleştiğinde kullanılır. Bunun bir örneği, web isteği için başarılı bir URL yetkilendirmesidir.

Aşağıdaki listede, türdeki WebSuccessAuditEvent olayların ASP.NET tarafından tetiklendiği özellikler açıklanmaktadır:

• Dosya Yetkilendirme. Başarılı koşullar denetleniyor. Dosya yetkilendirmesi yalnızca bir Windows Kimliği istekle ilişkilendirildiğinde ASP.NET tarafından denenmiştir. İlgili olay denetim kodu şeklindedir AuditFileAuthorizationSuccess.

• URL Yetkilendirmesi. Yetkilendirmenin verildiği URL kaynağına erişimi belirtir. Başarılı koşullar denetleniyor. İlgili olay denetim kodu şeklindedir AuditUrlAuthorizationSuccess.

• Diğer güvenlik koşulları. aşağıda ilgili olay kodlarının listesi verilmiştir:

  • AuditFormsAuthenticationSuccess

  • AuditMembershipAuthenticationSuccess

bir WebSuccessAuditEvent tetiklendiğinde, sistem durumu izleme ASP.NET ilgili Denetim Başarısı Olayları Yükseltilmiş performans sayacını artırır ve ardından yapılandırmayı healthMonitoring denetleyip herhangi bir sağlayıcının olaya abone olup olmadığını belirler. Sağlayıcılar olaya abone olursa, ASP.NET olayı işlenmek üzere onlara iletir.

Not

Sistem İzleyicisi'nde (PerfMon) Başarılı Olay Yükseltildi performans sayacını görüntülemek için, Sayaç Ekle penceresinde Performans nesnesi açılan listesinden ASP.NET seçin, Başarılı Olay Yükseltildi performans sayacını seçin ve Ekle düğmesine tıklayın. Daha fazla bilgi için bkz. uygulama performansını izleme ASP.NET.

Başarılı denetimler beklenen bir koşulu temsil ettiğinden, bunlara abone olmak istemeyebilirsiniz. Siteye erişim denetimi sağlamak için bunlara abone olabilirsiniz.

Not

Çoğu durumda, uygulanan ASP.NET sistem durumu izleme türlerini kullanabilir ve yapılandırma bölümünde değerleri healthMonitoring belirterek sistem durumu izleme sistemini denetleyebilirsiniz. Kendi özel olaylarınızı ve sağlayıcılarınızı oluşturmak için sistem durumu izleme türlerinden de türetebilirsiniz. sınıfından türetme WebSuccessAuditEvent örneği için bu konuda sağlanan örne bakın.

Oluşturucular

WebSuccessAuditEvent(String, Object, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebSuccessAuditEvent başlatır.
WebSuccessAuditEvent(String, Object, Int32, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebSuccessAuditEvent başlatır.

Özellikler

EventCode	Olayla ilişkili kod değerini alır. (Devralındığı yer: WebBaseEvent)
EventDetailCode	Olay ayrıntı kodunu alır. (Devralındığı yer: WebBaseEvent)
EventID	Olayla ilişkili tanımlayıcıyı alır. (Devralındığı yer: WebBaseEvent)
EventOccurrence	Olayın kaç kez gerçekleştiğini gösteren bir sayaç alır. (Devralındığı yer: WebBaseEvent)
EventSequence	Olayın uygulama tarafından kaç kez tetiklendiğini alır. (Devralındığı yer: WebBaseEvent)
EventSource	Olayı oluşturan nesneyi alır. (Devralındığı yer: WebBaseEvent)
EventTime	Olayın tetiklendiği zamanı alır. (Devralındığı yer: WebBaseEvent)
EventTimeUtc	Olayın tetiklendiği zamanı alır. (Devralındığı yer: WebBaseEvent)
Message	Olayı açıklayan iletiyi alır. (Devralındığı yer: WebBaseEvent)
ProcessInformation	ASP.NET uygulama barındırma işlemi hakkında bilgi alır. (Devralındığı yer: WebManagementEvent)
RequestInformation	Web isteğiyle ilişkili bilgileri alın. (Devralındığı yer: WebAuditEvent)

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FormatCustomEventDetails(WebEventFormatter)	Olay bilgilerinin standart biçimlendirmesini sağlar. (Devralındığı yer: WebBaseEvent)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IncrementPerfCounters()	Denetim Başarısı Olayları Yükseltilmiş performans sayacını artırır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Raise()	Yapılandırılmış sağlayıcılara olayın gerçekleştiğini bildirerek bir olayı tetikler. (Devralındığı yer: WebBaseEvent)
ToString()	Olay bilgilerini görüntüleme amacıyla biçimlendirin. (Devralındığı yer: WebBaseEvent)
ToString(Boolean, Boolean)	Olay bilgilerini görüntüleme amacıyla biçimlendirin. (Devralındığı yer: WebBaseEvent)

Ayrıca bkz.

• WebAuditEvent
• WebFailureAuditEvent
• WebEventCodes
• ASP.NET Sistem Durumunu İzlemeye Genel Bakış