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

Комментарии

Задает текущее свойство объекта , который представляет удостоверение пользователя для текущего запроса, если для проверки подлинности Mode задано значение Forms в элементе authentication Element (ASP.NET Settings Schema) файла конфигурации приложения.IPrincipalHttpContext.UserFormsAuthenticationModule

объект 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

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

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

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