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, FormsAuthentication_OnAuthenticate olayını kullanarak geçerlinin User özelliğini özel HttpContextbir GenericPrincipal nesnesine ayarlarIdentity.

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 FormsAuthenticationEventArgs kullanarak bir HttpContext nesne oluşturur ve FormsAuthentication_OnAuthenticate olayına geçirir.

özelliğini kullanarak User geçerli özelliğini özel User bir nesne olarak ayarlayabilirsiniz HttpContextIPrincipal.

User olayı sırasında özelliği için bir değer belirtmezseniz, tanımlama bilgisinde veya URL'de form 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

Name Description
FormsAuthenticationEventArgs(HttpContext)

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

Özellikler

Name Description
Context

HttpContext Geçerli HTTP isteğinin nesnesini alır.
User

Geçerli istekle ilişkilendirilecek nesneyi alır veya ayarlar IPrincipal .

Yöntemler

Name Description
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()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.