FormsAuthenticationEventArgs Klas

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll

Biedt gegevens voor de FormsAuthentication_OnAuthenticate gebeurtenis. Deze klasse kan niet worden overgenomen.

public ref class FormsAuthenticationEventArgs sealed : EventArgs
public sealed class FormsAuthenticationEventArgs : EventArgs
type FormsAuthenticationEventArgs = class
    inherit EventArgs
Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs
Overname
Object
EventArgs
FormsAuthenticationEventArgs

Voorbeelden

In het volgende codevoorbeeld wordt de gebeurtenis FormsAuthentication_OnAuthenticate gebruikt om de User eigenschap van de huidige HttpContext in te stellen op een GenericPrincipal object met een aangepast object 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

Opmerkingen

De FormsAuthenticationEventArgs klasse wordt gebruikt om gebeurteniswaarden op te geven aan de FormsAuthentication_OnAuthenticate gebeurtenis en om u in staat te stellen een aangepaste identiteit op te geven voor de huidige aanvraag.

Hiermee FormsAuthenticationModule wordt een FormsAuthenticationEventArgs object gemaakt met behulp van de huidige HttpContext en doorgegeven aan de FormsAuthentication_OnAuthenticate gebeurtenis.

U kunt de User eigenschap gebruiken om de eigenschap van de User huidige HttpContext in te stellen op een aangepast IPrincipal object.

Als u tijdens de FormsAuthentication_OnAuthenticate gebeurtenis geen waarde voor de User eigenschap opgeeft, wordt de identiteit van het formulierverificatieticket in de cookie of URL gebruikt.

De FormsAuthentication_OnAuthenticate gebeurtenis wordt alleen gegenereerd wanneer de verificatie Mode is ingesteld op Forms en de FormsAuthenticationModule is een actieve HTTP-module voor de toepassing.

Constructors

Name Description
FormsAuthenticationEventArgs(HttpContext)

Initialiseert een nieuw exemplaar van de FormsAuthenticationEventArgs klasse.

Eigenschappen

Name Description
Context

Hiermee haalt u het HttpContext object op voor de huidige HTTP-aanvraag.
User

Hiermee wordt het IPrincipal object opgehaald of ingesteld dat aan de huidige aanvraag moet worden gekoppeld.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook