FormsAuthenticationModule Třída

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Nastaví identitu uživatele pro ASP.NET aplikaci, když je povolené ověřování pomocí formulářů. Tuto třídu nelze zdědit.

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

Dědičnost

Object

FormsAuthenticationModule

Implementuje

IHttpModule

Příklady

Následující příklad používá FormsAuthentication_OnAuthenticate událost k nastavení User vlastnosti aktuální HttpContext na vlastní IPrincipal objekt.

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

Poznámky

Nastaví FormsAuthenticationModule aktuální vlastnost na IPrincipal objekt, který představuje identitu uživatele pro aktuální požadavek, pokud je ověřování Mode nastaveno Forms v elementu authentication Element (ASP.NET Settings Schema) konfiguračního souboru aplikace.HttpContext.User

Zveřejňuje FormsAuthenticationModuleAuthenticate událost, která umožňuje poskytnout vlastní IPrincipal objekt pro User vlastnost aktuálního HttpContext. K Authenticate události se přistupuje zadáním podprogramu s názvem FormsAuthentication_OnAuthenticate v souboru Global.asax pro vaši aplikaci ASP.NET.

Poznámka:

Ve službě IIS 7.0 není použití s WindowsAuthenticationModule podporou FormsAuthenticationModule podporováno. Další informace o problémech s kompatibilitou v integrovaných režimech naleznete v tématu Přesunutí aplikace ASP.NET ze služby IIS 6.0 do služby IIS 7.0.

Konstruktory

Name	Description
FormsAuthenticationModule()	Inicializuje novou instanci FormsAuthenticationModule třídy.

Metody

Name	Description
Dispose()	Uvolní všechny prostředky kromě paměti používané nástrojem FormsAuthenticationModule.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
Init(HttpApplication)	Inicializuje FormsAuthenticationModule objekt.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Name	Description
Authenticate	Nastane, když aplikace ověří aktuální požadavek.

Viz také

• Zprostředkovatel ověřování formulářů