Поделиться через

FormsAuthenticationModule Класс

Определение

Пространство имен:
System.Web.Security
Сборка:
System.Web.dll

Задает удостоверение пользователя для приложения ASP.NET при включении проверки подлинности форм. Этот класс не может быть унаследован.

public ref class FormsAuthenticationModule sealed : System::Web::IHttpModule
public sealed class FormsAuthenticationModule : System.Web.IHttpModule
type FormsAuthenticationModule = class
    interface IHttpModule
Public NotInheritable Class FormsAuthenticationModule
Implements IHttpModule
Наследование
Object
FormsAuthenticationModule
Реализации
IHttpModule

Примеры

В следующем примере используется событие FormsAuthentication_OnAuthenticate для задания User свойства текущего HttpContext пользовательского IPrincipal объекта.

public void FormsAuthentication_OnAuthenticate(object sender, FormsAuthenticationEventArgs args)
{
  if (FormsAuthentication.CookiesSupported)
  {
    if (Request.Cookies[FormsAuthentication.FormsCookieName] != null)
    {
      try
      {
        FormsAuthenticationTicket ticket = FormsAuthentication.Decrypt(
          Request.Cookies[FormsAuthentication.FormsCookieName].Value);
        
        args.User = new System.Security.Principal.GenericPrincipal(
          new Samples.AspNet.Security.MyFormsIdentity(ticket),
          new string[0]);
      }
      catch (Exception e)
      {
        // Decrypt method failed.
      }
    }
  }
  else
  {
    throw new HttpException("Cookieless Forms Authentication is not " +
                            "supported for this application.");
  }
}

Public Sub FormsAuthentication_OnAuthenticate(sender As Object, _
                                              args As FormsAuthenticationEventArgs)
  If FormsAuthentication.CookiesSupported Then
    If Not Request.Cookies(FormsAuthentication.FormsCookieName) Is Nothing Then
      Try
        Dim ticket As FormsAuthenticationTicket = FormsAuthentication.Decrypt( _
          Request.Cookies(FormsAuthentication.FormsCookieName).Value)
        
        args.User = New System.Security.Principal.GenericPrincipal( _
          New Samples.AspNet.Security.MyFormsIdentity(ticket), _
          New String(0) {})
      Catch e As HttpException
        ' Decrypt method failed.
      End Try
    End If
  Else
      Throw New Exception("Cookieless Forms Authentication is not " & _
                            "supported for this application.")
  End If
End Sub

Комментарии

Задает FormsAuthenticationModule текущее HttpContext.User свойство IPrincipal объекту, представляющего удостоверение пользователя для текущего запроса, если проверка подлинности задана Forms в элементе проверки подлинностиMode (ASP.NET схема параметров) файла конфигурации приложения.

Предоставляет FormsAuthenticationModule событие, позволяющее предоставить пользовательский IPrincipal объект для User свойства текущегоHttpContext.Authenticate Доступ Authenticate к событию осуществляется путем указания подзадачей с именем FormsAuthentication_OnAuthenticate в файле Global.asax для приложения ASP.NET.

Замечание

В IIS 7.0 использование WindowsAuthenticationModule с FormsAuthenticationModule ним не поддерживается. Дополнительные сведения о проблемах совместимости в интегрированных режимах см. в разделе "Перемещение приложения ASP.NET из IIS 6.0 в IIS 7.0".

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

Имя Описание
FormsAuthenticationModule()

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

Методы

Имя Описание
Dispose()

Освобождает все ресурсы, отличные от памяти, используемой параметром FormsAuthenticationModule.
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
Init(HttpApplication)

Инициализирует объект FormsAuthenticationModule.
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

События

Имя Описание
Authenticate

Происходит, когда приложение выполняет проверку подлинности текущего запроса.

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

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