FormsAuthenticationEventArgs Sınıf

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

FormsAuthentication_OnAuthenticate olayı için veri sağlar. Bu sınıf devralınamaz.

public ref class FormsAuthenticationEventArgs sealed : EventArgs

public sealed class FormsAuthenticationEventArgs : EventArgs

type FormsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs

Devralma

Object

EventArgs

FormsAuthenticationEventArgs

Örnekler

Aşağıdaki kod örneği, geçerli HttpContext özelliğini özel Identitybir GenericPrincipal nesnesine ayarlamak User için FormsAuthentication_OnAuthenticate olayını kullanır.

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

Açıklamalar

sınıfı FormsAuthenticationEventArgs , FormsAuthentication_OnAuthenticate olayına olay değerleri sağlamak ve geçerli istek için özel bir kimlik belirtmenizi sağlamak için kullanılır.

, FormsAuthenticationModule geçerli HttpContext kullanarak bir FormsAuthenticationEventArgs nesnesi oluşturur ve FormsAuthentication_OnAuthenticate olayına geçirir.

özelliğini kullanarak User geçerli özelliğini özel IPrincipal bir nesneye ayarlayabilirsiniz UserHttpContext.

FormsAuthentication_OnAuthenticate olayı sırasında özelliği için User bir değer belirtmezseniz, tanımlama bilgisinde veya URL'de forms kimlik doğrulama bileti tarafından sağlanan kimlik kullanılır.

FormsAuthentication_OnAuthenticate olayı yalnızca kimlik doğrulaması Mode olarak ayarlandığında Forms ve FormsAuthenticationModule uygulama için etkin bir HTTP modülü olduğunda oluşturulur.

Oluşturucular

FormsAuthenticationEventArgs(HttpContext)

FormsAuthenticationEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

Context	HttpContext Geçerli HTTP isteğinin nesnesini alır.
User	Geçerli istekle ilişkilendirilecek nesneyi alır veya ayarlar IPrincipal .

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Forms Kimlik Doğrulama Sağlayıcısı