Udostępnij za pośrednictwem


FormsAuthenticationEventArgs Klasa

Definicja

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
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)

Dotyczy

Zobacz też