WebAuthenticationFailureAuditEvent Sınıf

Tanım

ASP.NET kimlik doğrulaması hataları hakkında bilgi sağlar.

public ref class WebAuthenticationFailureAuditEvent : System::Web::Management::WebFailureAuditEvent
public class WebAuthenticationFailureAuditEvent : System.Web.Management.WebFailureAuditEvent
type WebAuthenticationFailureAuditEvent = class
    inherit WebFailureAuditEvent
Public Class WebAuthenticationFailureAuditEvent
Inherits WebFailureAuditEvent
Devralma

Örnekler

Aşağıdaki kod örneği sınıfının nasıl kullanılacağını WebAuthenticationFailureAuditEvent gösterir.


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

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

        // Invoked in case of events identified only by 
        // their event code.
        public SampleWebAuthenticationFailureAuditEvent(
            string msg, object eventSource, 
            int eventCode, string userName):
        base(msg, eventSource, eventCode, userName)
        {
            // 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 SampleWebAuthenticationFailureAuditEvent(
            string msg, object eventSource,
            int eventCode, int detailedCode, string userName):
        base(msg, eventSource, eventCode, detailedCode, userName)
        {
            // Perform custom initialization.
            customCreatedMsg =
            string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }


        // Raises the SampleWebAuthenticationFailureAuditEvent.
        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(
                "* SampleWebAuthenticationFailureAuditEvent 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(
                "* SampleWebAuthenticationFailureAuditEvent End *");

            formatter.IndentationLevel -= 1;
        }
    }
}
Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebAuthenticationFailureAuditEvent class. 

Public Class SampleWebAuthenticationFailureAuditEvent
    Inherits System.Web.Management.WebAuthenticationFailureAuditEvent
    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, _
    ByVal userName As String)
        MyBase.New(msg, eventSource, eventCode, userName)
        ' 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, _
    ByVal userName As String)
        MyBase.New(msg, eventSource, eventCode, _
        detailedCode, userName)
        ' Perform custom initialization.
        customCreatedMsg = _
        String.Format( _
        "Event created at: {0}", DateTime.Now.TimeOfDay.ToString())

    End Sub



    ' Raises the SampleWebAuthenticationFailureAuditEvent.
    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( _
        "* SampleWebAuthenticationFailureAuditEvent 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( _
        "* SampleWebAuthenticationFailureAuditEvent End *")

        formatter.IndentationLevel -= 1

    End Sub
End Class

Açıklamalar

Aşağıdaki listede, olayların varsayılan olarak ASP.NET tarafından tetiklendiği WebAuthenticationFailureAuditEvent özellikler açıklanmaktadır.

Not

Varsayılan olarak ASP.NET yalnızca denetim hatası koşullarını günlüğe kaydedecek şekilde yapılandırılır çünkü günlüğe kaydetme başarı koşulları sistem kaynaklarını ciddi ölçüde zorlayabilir. Sistemi her zaman başarı koşullarını günlüğe kaydedecek şekilde yapılandırabilirsiniz.

  • Forms Kimlik Doğrulaması. Başarılı denetimler kimliği doğrulanmış kullanıcı adını içerirken; hata denetimleri kullanıcı adını içermez, çünkü bunlar genellikle şifre çözme veya doğrulamada başarısız olan bir anahtardan kaynaklanmaz. her ikisi de istemci IP adresini içerir. İlgili olay denetim kodu şeklindedir AuditFormsAuthenticationFailure.

  • Üyelik. Hem başarı hem de başarısızlık denetimleri, denenen kullanıcı adını içerir. Her iki denetim biçimi de denenen parolayı içermez çünkü bu, günlükte geçerli bir parolanın kalıcı olmasını riske atacaktır. İlgili olay denetim kodu şeklindedir AuditMembershipAuthenticationFailure.

yükseltildiğinde WebAuthenticationFailureAuditEvent , varsayılan olarak Denetim Kimlik Doğrulama Hatası Olayları Yükseltilmiş performans sayacını güncelleştirir. Bu performans sayacını Sistem İzleyicisi'nde (PerfMon) görüntülemek için , Sayaç Ekle penceresinde ASP.NETPerformans nesnesi açılan listesinden Kimlik Doğrulama Hatası Olayları Yükseltilmiş performans sayacını seçin ve Ekle düğmesine tıklayın. Daha fazla bilgi için bkz. ASP.NET Uygulamaları ile Sistem İzleyicisi'ni (PerfMon) kullanma.

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 WebAuthenticationFailureAuditEvent örneği için bu konuda sağlanan örne bakın.

Oluşturucular

WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)

Belirtilen olay parametreleriyle sınıfının yeni bir örneğini WebAuthenticationFailureAuditEvent başlatır.

WebAuthenticationFailureAuditEvent(String, Object, Int32, String)

Belirtilen olay parametreleriyle sınıfının yeni bir örneğini WebAuthenticationFailureAuditEvent 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)
NameToAuthenticate

Kimlik doğrulaması için kullanıcının adını alır.

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.

(Devralındığı yer: WebFailureAuditEvent)
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

Ayrıca bkz.