FormsAuthenticationModule Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Ustawia tożsamość użytkownika dla aplikacji ASP.NET po włączeniu uwierzytelniania formularzy. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

FormsAuthenticationModule

Implementuje

IHttpModule

Przykłady

W poniższym przykładzie użyto zdarzenia FormsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego obiektu HttpContext na obiekt niestandardowy 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

Uwagi

Ustawia FormsAuthenticationModule bieżącą HttpContext.UserIPrincipal właściwość na obiekt, który reprezentuje tożsamość użytkownika dla bieżącego żądania, gdy uwierzytelnianie jest ustawione na Forms w elemencie element uwierzytelnianiaMode (ASP.NET Ustawienia Schemat) pliku konfiguracji aplikacji.

Uwidacznia FormsAuthenticationModuleAuthenticate zdarzenie, które umożliwia podanie obiektu niestandardowego IPrincipal dla User właściwości bieżącego HttpContextobiektu . Do Authenticate zdarzenia uzyskuje się dostęp, określając podprotynę o nazwie FormsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET.

Uwaga

W usługach IIS 7.0 użycie elementu WindowsAuthenticationModule z programem FormsAuthenticationModule nie jest obsługiwane. Aby uzyskać więcej informacji na temat problemów ze zgodnością w trybach zintegrowanych, zobacz Przenoszenie aplikacji ASP.NET z usług IIS 6.0 do usług IIS 7.0.

Konstruktory

FormsAuthenticationModule()

Inicjuje nowe wystąpienie klasy FormsAuthenticationModule.

Metody

Dispose()	Zwalnia wszystkie zasoby, inne niż pamięć, używane przez FormsAuthenticationModuleprogram .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Init(HttpApplication)	Inicjuje FormsAuthenticationModule obiekt.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Authenticate

Występuje, gdy aplikacja uwierzytelnia bieżące żądanie.

Zobacz też

• Dostawca uwierzytelniania formularzy