FormsAuthenticationEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Udostępnia dane zdarzenia FormsAuthentication_OnAuthenticate . Klasa ta nie może być dziedziczona.

public ref class FormsAuthenticationEventArgs sealed : EventArgs

public sealed class FormsAuthenticationEventArgs : EventArgs

type FormsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs

Dziedziczenie

Object

EventArgs

FormsAuthenticationEventArgs

Przykłady

Poniższy przykład kodu używa zdarzenia FormsAuthentication_OnAuthenticate, aby ustawić UserGenericPrincipal właściwość bieżącego HttpContext obiektu na niestandardowy Identity.

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

Klasa FormsAuthenticationEventArgs służy do podawania wartości zdarzeń do zdarzenia FormsAuthentication_OnAuthenticate i umożliwia określenie tożsamości niestandardowej dla bieżącego żądania.

Obiekt FormsAuthenticationModule tworzy FormsAuthenticationEventArgs obiekt przy użyciu bieżącego HttpContext elementu i przekazuje go do zdarzenia FormsAuthentication_OnAuthenticate .

Można użyć właściwości , User aby ustawić User właściwość bieżącego HttpContext obiektu niestandardowego IPrincipal .

Jeśli nie określisz wartości właściwości User podczas zdarzenia FormsAuthentication_OnAuthenticate , zostanie użyta tożsamość dostarczona przez bilet uwierzytelniania formularzy w pliku cookie lub adresIE URL.

Zdarzenie FormsAuthentication_OnAuthenticate jest zgłaszane tylko wtedy, gdy uwierzytelnianie Mode jest ustawione Forms i FormsAuthenticationModule jest aktywnym modułem HTTP dla aplikacji.

Konstruktory

FormsAuthenticationEventArgs(HttpContext)

Inicjuje nowe wystąpienie klasy FormsAuthenticationEventArgs.

Właściwości

Context	HttpContext Pobiera obiekt dla bieżącego żądania HTTP.
User	Pobiera lub ustawia IPrincipal obiekt do skojarzenia z bieżącym żądaniem.

Metody

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)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Dostawca uwierzytelniania formularzy