WebFailureAuditEvent Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Management

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Güvenlik hataları hakkında bilgi sağlar.

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

public class WebFailureAuditEvent : System.Web.Management.WebAuditEvent

type WebFailureAuditEvent = class
    inherit WebAuditEvent

Public Class WebFailureAuditEvent
Inherits WebAuditEvent

Devralma: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent
WebFailureAuditEvent

Türetilmiş: System.Web.Management.WebAuthenticationFailureAuditEvent

System.Web.Management.WebViewStateFailureAuditEvent

Örnekler

Aşağıdaki kod örneği, özel denetim olayı oluşturmak için sınıfından WebFailureAuditEvent nasıl türetilmiş olduğunu gösterir.


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

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


' Implements a custom WebFailureAuditEvent class. 

Public Class SampleWebFailureAuditEvent
    Inherits System.Web.Management.WebFailureAuditEvent
    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 SampleWebFailureAuditEvent.
    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 is 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("******** 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

    End Sub

End Class

Aşağıdaki yapılandırma alıntısı, ASP.NET olayı kullanmasının nasıl etkinleştirileceği gösterilmektedir WebFailureAuditEvent .

<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="SampleWebFailureAuditEvent"
type="SamplesAspNet.SampleWebFailureAuditEvent,
webfailureauditevent,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.

sınıfı WebFailureAuditEvent , bir güvenlik işlemi başarısız olduğunda kullanılır. Bunun bir örneği, bir Web isteği için başarısız URL yetkilendirmesidir.

Varsayılan olarak, ASP.NET aşağıdaki özellikler için olayı tetikleye WebFailureAuditEvent yapılandırılır:

Dosya yetkilendirme. ASP.NET dosya yetkilendirmeyi yalnızca bir Windows Kimliği istekle ilişkilendirildiğinde dener. İlgili olay denetim kodu şeklindedir AuditFileAuthorizationFailure.
URL yetkilendirmesi. Bu, bir URL kaynağına yetkisiz erişim girişimlerini yönetir. Anonim kimlik doğrulama hatası çoğu durumda kabul edilebilir olduğundan anonim kullanıcının başarısız denemeleri denetlenmiyor. İlgili olay denetim kodu şeklindedir AuditUrlAuthorizationFailure.
İşlenmeyen genel koşullar veya işlenmeyen güvenlik koşulları. Aşağıda, bu koşullarla ilgili olay kodlarının listesi verilmiştir:

Bir WebFailureAuditEvent olay tetiklendiğinde, sistem durumu izleme ASP.NET ilgili Denetim Hatası Olayları Yükseltilmiş performans sayacını artırır ve ardından yapılandırma bölümünü denetleyip healthMonitoring 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) Denetim Hatası Olayları Yükseltilmiş performans sayacını görüntülemek için Sayaç Ekle penceresinde Performans nesnesi açılan listesinden ASP.NET seçin, Denetim Hatası Olayları Yükseltilmiş performans sayacını seçin ve Ekle düğmesine tıklayın.

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 WebFailureAuditEvent örneği için Örnek bölümüne bakın.

Devralanlara Notlar

Görüntü için özel olay bilgilerinizi biçimlendirirken, yöntemi yerine ToString yöntemini geçersiz kılınFormatCustomEventDetails(WebEventFormatter). Bu, hassas sistem bilgilerinin üzerine yazılmasını veya kurcalanmasını önler.

Oluşturucular

WebFailureAuditEvent(String, Object, Int32, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebFailureAuditEvent başlatır.
WebFailureAuditEvent(String, Object, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebFailureAuditEvent 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 Hatası 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)

Şunlara uygulanır

Aracılığıyla paylaş