FormsAuthenticationModule Osztály

Definíció

Névtér:
System.Web.Security
Szerelvény:
System.Web.dll

Beállítja a felhasználó identitását egy ASP.NET-alkalmazáshoz az űrlaphitelesítés engedélyezésekor. Ez az osztály nem örökölhető.

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
Öröklődés
Object
FormsAuthenticationModule
Megvalósítás
IHttpModule

Példák

Az alábbi példa az FormsAuthentication_OnAuthenticate esemény használatával állítja be az User aktuális HttpContext tulajdonságot egy egyéni IPrincipal objektumra.

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

Megjegyzések

A az aktuális tulajdonságot egy objektumra állítja, amely az aktuális kérés felhasználói identitását jelöli, amikor a hitelesítés értékre van állítva az alkalmazás konfigurációs fájljának ASP.NET ahitelesítési elemében.

Az FormsAuthenticationModule esemény olyan eseményt Authenticate tesz elérhetővé, amely lehetővé teszi, hogy egyéni IPrincipal objektumot adjon meg az User aktuális HttpContexttulajdonsághoz. A Authenticate esemény egy FormsAuthentication_OnAuthenticate nevű alrutin megadásával érhető el a ASP.NET-alkalmazás Global.asax fájljában.

Note

Az IIS 7.0-ban a WindowsAuthenticationModule with the FormsAuthenticationModule használata nem támogatott. Az integrált módban előforduló kompatibilitási problémákról további információt Az ASP.NET-alkalmazások IIS 6.0-ról IIS 7.0-ra történő váltása című témakörben talál.

Konstruktorok

Name Description
FormsAuthenticationModule()

Inicializálja a FormsAuthenticationModule osztály új példányát.

Metódusok

Name Description
Dispose()

Felszabadítja az összes erőforrást, a memória kivételével, amelyet a FormsAuthenticationModulerendszer használ.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
Init(HttpApplication)

Inicializálja a FormsAuthenticationModule objektumot.
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

esemény

Name Description
Authenticate

Akkor fordul elő, ha az alkalmazás hitelesíti az aktuális kérést.

A következőre érvényes:

Lásd még