WebFailureAuditEvent Sınıf

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 türetme işlemini 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 WebFailureAuditEvent olayını kullanmasını nasıl etkinleştirileceği gösterir.

<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 durumunu 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 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 WebFailureAuditEvent olayını yükseltecek şekilde 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 bir 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ı. Bu koşullarla ilgili olay kodlarının listesi aşağıda verilmiştir:

bir WebFailureAuditEvent olayı oluşturulduğunda, sistem durumu izleme ASP.NET ilgili Denetim Hatası Olayları Yükseltilmiş performans sayacını artırır ve ardından healthMonitoring yapılandırma bölümünü denetleyip herhangi bir sağlayıcının olaya abone olup olmadığını belirler. Sağlayıcılar olaya abone olursa, ASP.NET işlenmek üzere olayı onlara iletir.

Note

Sistem İzleyicisi'nde (PerfMon) Denetim Hatası Olayları Yükseltilmiş performans sayacını görüntülemek için, D Sayaçları Ekle penceresinde, Performance nesnesi açılan listesinden ASP.NET öğesini seçin, Audit Failure Events Raised performans sayacını seçin, ve Add düğmesine tıklayın.

Note

Çoğu durumda, uygulanan ASP.NET sistem durumu izleme türlerini kullanabilir ve healthMonitoring yapılandırma bölümünde değerleri 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 FormatCustomEventDetails(WebEventFormatter) yöntemini geçersiz kılınToString. Bu, hassas sistem bilgilerinin üzerine yazılmasını veya üzerinde oynanmasını önler.

Oluşturucular

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

Name	Description
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ı tetikleyen nesneyi alır. (Devralındığı yer: WebBaseEvent)
EventTime	Olayın oluşturulduğu zamanı alır. (Devralındığı yer: WebBaseEvent)
EventTimeUtc	Olayın oluşturulduğu 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

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IncrementPerfCounters()	Denetim Hatası Olayları Yükseltilmiş performans sayacını artırır.
MemberwiseClone()	Geçerli Objectbasit 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 oluşturur. (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

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?