WebAuthenticationFailureAuditEvent Класс

Ссылка

Определение

Пространство имен:: System.Web.Management

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет сведения о сбоях проверки подлинности 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

Наследование: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebFailureAuditEvent
WebAuthenticationFailureAuditEvent

Примеры

Приведенный ниже пример кода показывает, как использовать класс WebAuthenticationFailureAuditEvent.


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

По умолчанию ASP.NET настроено для ведения журнала только условий сбоя аудита, так как условия успешного ведения журнала могут серьезно напрягать системные ресурсы. Вы всегда можете настроить систему для регистрации условий успешного выполнения.

Проверка подлинности с помощью форм. В то время как аудит успешного выполнения включает имя пользователя, прошедшего проверку подлинности; аудит ошибок не включает имя пользователя, так как обычно они возникают в результате запроса, который не удалось расшифровать или проверить. Оба содержат IP-адрес клиента. Связанный код аудита событий — AuditFormsAuthenticationFailure.
Членство. Аудит успешного и неудачного выполнения содержит имя пользователя, которое было предприняло попытку. Ни в той из форм аудита, которая была предпринята, не будет содержаться пароль, который был предпринят, так как это приведет к риску сохранения допустимого пароля в журнале. Связанный код аудита событий — AuditMembershipAuthenticationFailure.

WebAuthenticationFailureAuditEvent При возникновении по умолчанию обновляется счетчик производительности События сбоя аудита проверки подлинности. Чтобы просмотреть этот счетчик производительности в системном мониторе (PerfMon), в окне Добавление счетчиков выберите ASP.NET в раскрывающемся списке Объект Производительности , выберите счетчик производительности События сбоя проверки подлинности и нажмите кнопку Добавить . Дополнительные сведения см. в статье Использование системного монитора (PerfMon) с приложениями ASP.NET.

Примечание

В большинстве случаев вы сможете использовать ASP.NET типы мониторинга работоспособности, как реализовано, и вы будете управлять системой мониторинга работоспособности, указав значения в healthMonitoring разделе конфигурации. Вы также можете наследовать от типов мониторинга работоспособности для создания собственных пользовательских событий и поставщиков. Пример наследования от WebAuthenticationFailureAuditEvent класса см. в примере, приведенном в этом разделе.

Конструкторы

WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)	Инициализирует новый экземпляр класса WebAuthenticationFailureAuditEvent с указанными параметрами события.
WebAuthenticationFailureAuditEvent(String, Object, Int32, String)	Инициализирует новый экземпляр класса WebAuthenticationFailureAuditEvent с указанными параметрами события.

Свойства

EventCode	Получает значение кода, связанное с событием. (Унаследовано от WebBaseEvent)
EventDetailCode	Получает подробный код события. (Унаследовано от WebBaseEvent)
EventID	Получает идентификатор, связанный с событием. (Унаследовано от WebBaseEvent)
EventOccurrence	Получает значение счетчика, показывающее, сколько раз произошло событие. (Унаследовано от WebBaseEvent)
EventSequence	Получает количество порождений события приложением. (Унаследовано от WebBaseEvent)
EventSource	Получает объект, порождающий событие. (Унаследовано от WebBaseEvent)
EventTime	Получает время порождения события. (Унаследовано от WebBaseEvent)
EventTimeUtc	Получает время порождения события. (Унаследовано от WebBaseEvent)
Message	Получает сообщение, описывающее событие. (Унаследовано от WebBaseEvent)
NameToAuthenticate	Возвращает имя пользователя для проверки подлинности.
ProcessInformation	Получает сведения о размещающем приложение процессе ASP.NET. (Унаследовано от WebManagementEvent)
RequestInformation	Получает сведения, связанные с веб-запросом. (Унаследовано от WebAuditEvent)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FormatCustomEventDetails(WebEventFormatter)	Обеспечивает стандартное форматирование сведений о событии. (Унаследовано от WebBaseEvent)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IncrementPerfCounters()	Увеличивает значение счетчика событий аудита отказов. (Унаследовано от WebFailureAuditEvent)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Raise()	Порождает событие, уведомляя любого настроенного поставщика о произошедшем событии. (Унаследовано от WebBaseEvent)
ToString()	Форматирует сведения события для последующего отображения. (Унаследовано от WebBaseEvent)
ToString(Boolean, Boolean)	Форматирует сведения события для последующего отображения. (Унаследовано от WebBaseEvent)

Применяется к

WebAuthenticationFailureAuditEvent Класс

Определение

Примеры

Комментарии

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

Обратная связь

Дополнительные ресурсы