FormsAuthenticationModule Класс

Определение

Задает удостоверение пользователя для приложения 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
Наследование
FormsAuthenticationModule
Реализации

Примеры

В следующем примере используется событие FormsAuthentication_OnAuthenticate для задания User свойства Current 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 объект, представляющий удостоверение пользователя для текущего запроса, когда для проверки подлинности Mode задан элемент Forms authentication (схема параметров ASP.NET) файла конфигурации приложения.

FormsAuthenticationModuleПредоставляет Authenticate событие, которое позволяет предоставить пользовательский IPrincipal объект для User свойства текущего объекта HttpContext . Доступ к этому 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

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

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

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