DefaultAuthenticationModule Класс

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.dll

Гарантирует, что объект проверки подлинности присутствует в контексте. Этот класс не может быть унаследован.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

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

Object

DefaultAuthenticationModule

Реализации

IHttpModule

Примеры

В следующем примере используется событие DefaultAuthentication_OnAuthenticate для проверки того, является nullли User свойство текущего HttpContext экземпляра. User Если свойство равноnull, то пример задает User свойство текущего GenericPrincipalHttpContext экземпляра GenericPrincipal объекту, Name где Identity объект является GenericIdentity значением по умолчанию.

Замечание

Событие DefaultAuthentication_OnAuthenticate вызывается перед событием AuthorizeRequest . В результате, если задать User свойство текущего HttpContext экземпляра пользовательскому удостоверению, это может повлиять на поведение приложения. Например, если вы используете FormsAuthentication класс и указываете <deny users="?" /> в разделе конфигурации авторизации , чтобы убедиться, что у пользователей, прошедших проверку подлинности, есть доступ к сайту, этот пример приведет к тому, что элемент запрета будет игнорироваться, так как у пользователя будет имя, которое имеет значение по умолчанию. Вместо этого необходимо указать <deny users="default" /> , чтобы только прошедшие проверку подлинности пользователи могли получить доступ к сайту.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}

Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Комментарии

Гарантирует DefaultAuthenticationModule , что User свойство текущего HttpContext экземпляра задано IPrincipal для объекта для каждого запроса. Проверяет DefaultAuthenticationModule свойство после AuthenticateRequest события и перед событиемAuthorizeRequest.User User Если это свойство имеет значение, DefaultAuthenticationModule свойство nullзадает User объектуGenericPrincipal, который не содержит сведений о пользователе.

Если модуль проверки подлинности задает StatusCode для свойства значение 401, DefaultAuthenticationModule отобразится страница ошибки, отказано в доступе. Если для свойства задано значение StatusCode больше 200, DefaultAuthenticationModule объект завершит запрос. В этом случае до завершения текущего запроса вызываются только модули HTTP, подписывающиеся на EndRequest событие.

Authenticate Предоставляет DefaultAuthenticationModule событие. Это событие можно использовать для предоставления пользовательского IPrincipal объекта для User свойства текущего HttpContext экземпляра. Доступ Authenticate к событию осуществляется путем указания события с именем DefaultAuthentication_OnAuthenticate в файле Global.asax приложения.

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

Имя	Описание
DefaultAuthenticationModule()	Инициализирует новый экземпляр класса DefaultAuthenticationModule.

Методы

Имя	Описание
Dispose()	Освобождает все ресурсы, отличные от памяти, используемой параметром DefaultAuthenticationModule.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Init(HttpApplication)	Инициализирует объект DefaultAuthenticationModule.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Имя	Описание
Authenticate	Происходит после проверки подлинности запроса.

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

• проверка подлинности ASP.NET