| FormsAuthenticationModule | |
| System.Web.Security (system.web.dll) | sealed class |
This module, when loaded through the web.config
file (<authentication mode="Forms">),
provides Forms-based authentication. In this model, the ASP.NET
framework uses a special authentication cookie. If it is not present,
users are redirected to a custom ASP.NET page where they can acquire
the cookie once they log in successfully. If the cookie is present,
ASP.NET fires the Authenticate event, places
identity information in the
System.Web.HttpContext.User property, and allows
access. You can react to this event by creating an event handler
called FormsAuthentication_OnAuthenticate in the
global.asax file.
Several additional settings, including the URL for the login page and
the length of time before the cookie expires, can be set in the
web.config file. The actual authentication for
the user is performed in the custom code you create for the login
page. This code uses the helper methods in the
FormsAuthentication class to authenticate the user
and assign the Forms authentication cookie.
public sealed class FormsAuthenticationModule : System.Web.IHttpModule {
// Public Constructors
public
FormsAuthenticationModule ( );
// Public Instance Methods
public void
Dispose ( ); // implements System.Web.IHttpModule
public void
Init (System.Web.HttpApplication
app ); // implements System.Web.IHttpModule
// Events
public event FormsAuthenticationEventHandler
Authenticate ;
}