WebAuthenticationFailureAuditEvent Třída

Definice

Obor názvů:: System.Web.Management

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje informace o selhání ověřování ASP.NET.

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

Dědičnost: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebFailureAuditEvent
WebAuthenticationFailureAuditEvent

Příklady

Následující příklad kódu ukazuje, jak používat WebAuthenticationFailureAuditEvent třídu.


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

Poznámky

Následující seznam popisuje funkce, pro které WebAuthenticationFailureAuditEvent události jsou ve výchozím nastavení vyvolány ASP.NET.

Note

Ve výchozím nastavení je ASP.NET nakonfigurované tak, aby protokoloval pouze podmínky selhání auditu, protože podmínky úspěchu protokolování můžou vážně zatížit systémové prostředky. Systém můžete vždy nakonfigurovat tak, aby protokoloval podmínky úspěchu.

Ověřování pomocí formulářů Audity úspěchu zahrnují uživatelské jméno, které bylo ověřeno; Audity selhání nezahrnují uživatelské jméno, protože obvykle pochází z lístku, který selhal při dešifrování nebo ověření. Oba obsahují IP adresu klienta. Související kód auditu událostí je AuditFormsAuthenticationFailure.
Členství. Audity úspěchu i selhání obsahují uživatelské jméno, které se pokusilo. Žádná forma auditu nebude obsahovat heslo, které se pokusilo, protože by to riskovalo zachování platného hesla v protokolu. Související kód auditu událostí je AuditMembershipAuthenticationFailure.

WebAuthenticationFailureAuditEvent Při vyvolání se ve výchozím nastavení aktualizuje čítač výkonu vyvolaný událostmi selhání ověřování auditu. Chcete-li zobrazit tento čítač výkonu v nástroji Sledování systému (PerfMon), v okně Přidat čítače < vyberte v rozevíracím seznamu objektů >c2 vyberte čítač výkonu Vygenerovaných událostí selhání ověřování a klikněte na tlačítko Přidat. Další informace najdete v tématu Usání monitorování systému (PerfMon) s ASP.NET Aplikace.

Note

Ve většině případů budete moct používat typy monitorování stavu ASP.NET, které jsou implementované, a systém monitorování stavu budete řídit zadáním hodnot v části konfigurace healthMonitoring. Můžete také odvodit z typů monitorování stavu a vytvořit vlastní události a zprostředkovatele. Příklad odvození z třídy naleznete v příkladu WebAuthenticationFailureAuditEvent uvedeném v tomto tématu.

Konstruktory

Name	Description
WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)	Inicializuje novou instanci WebAuthenticationFailureAuditEvent třídy se zadanými parametry události.
WebAuthenticationFailureAuditEvent(String, Object, Int32, String)	Inicializuje novou instanci WebAuthenticationFailureAuditEvent třídy se zadanými parametry události.

Vlastnosti

Name	Description
EventCode	Získá hodnotu kódu přidruženou k události. (Zděděno od WebBaseEvent)
EventDetailCode	Získá kód podrobností události. (Zděděno od WebBaseEvent)
EventID	Získá identifikátor přidružený k události. (Zděděno od WebBaseEvent)
EventOccurrence	Získá čítač, který představuje počet výskytů události. (Zděděno od WebBaseEvent)
EventSequence	Získá počet vyvolání události aplikací. (Zděděno od WebBaseEvent)
EventSource	Získá objekt, který vyvolá událost. (Zděděno od WebBaseEvent)
EventTime	Získá čas, kdy byla událost vyvolána. (Zděděno od WebBaseEvent)
EventTimeUtc	Získá čas, kdy byla událost vyvolána. (Zděděno od WebBaseEvent)
Message	Získá zprávu, která popisuje událost. (Zděděno od WebBaseEvent)
NameToAuthenticate	Získá jméno uživatele k ověření.
ProcessInformation	Získá informace o ASP.NET procesu hostování aplikací. (Zděděno od WebManagementEvent)
RequestInformation	Získejte informace přidružené k webové žádosti. (Zděděno od WebAuditEvent)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FormatCustomEventDetails(WebEventFormatter)	Poskytuje standardní formátování informací o události. (Zděděno od WebBaseEvent)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IncrementPerfCounters()	Zvýší čítač výkonu událostí selhání auditu. (Zděděno od WebFailureAuditEvent)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Raise()	Vyvolá událost oznámením libovolného nakonfigurovaného zprostředkovatele, že došlo k události. (Zděděno od WebBaseEvent)
ToString()	Formátuje informace o událostech pro účely zobrazení. (Zděděno od WebBaseEvent)
ToString(Boolean, Boolean)	Formátuje informace o událostech pro účely zobrazení. (Zděděno od WebBaseEvent)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?