FormsAuthenticationModule Klasa

Definicja

Namespace:

System.Web.Security

Montaż:

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.

Konstruktorów

Nazwa	Opis
FormsAuthenticationModule()	Inicjuje nowe wystąpienie klasy FormsAuthenticationModule.

Metody

Nazwa	Opis
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. (Dziedziczone od Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
Init(HttpApplication)	Inicjuje FormsAuthenticationModule obiekt.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)

Zdarzenia

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

Zobacz także

• Dostawca uwierzytelniania formularzy