FormsAuthenticationEventHandler Делегат

Определение

Представляет метод, обрабатывающий событие FormsAuthentication_OnAuthenticate объекта FormsAuthenticationModule.Represents the method that handles the FormsAuthentication_OnAuthenticate event of a FormsAuthenticationModule.

public delegate void FormsAuthenticationEventHandler(System::Object ^ sender, FormsAuthenticationEventArgs ^ e);
public delegate void FormsAuthenticationEventHandler(object sender, FormsAuthenticationEventArgs e);
type FormsAuthenticationEventHandler = delegate of obj * FormsAuthenticationEventArgs -> unit
Public Delegate Sub FormsAuthenticationEventHandler(sender As Object, e As FormsAuthenticationEventArgs)

Параметры

sender
Object

Источник события.The source of the event.

e
FormsAuthenticationEventArgs

Объект FormsAuthenticationEventArgs, содержащий данные события.A FormsAuthenticationEventArgs that contains the event data.

Наследование
FormsAuthenticationEventHandler

Примеры

В следующем примере кода событие FormsAuthentication_OnAuthenticate используется User для задания свойства Current HttpContext для GenericPrincipal объекта с пользовательским Identity.The following code example uses the FormsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a GenericPrincipal object with a custom 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

Комментарии

Делегат определяется Authenticate для событияFormsAuthenticationModule класса. FormsAuthenticationEventHandlerThe FormsAuthenticationEventHandler delegate is defined for the Authenticate event of the FormsAuthenticationModule class. Чтобы получить доступ к Authenticate событию FormsAuthenticationModule класса, укажите подпрограммы с именем FormsAuthentication_OnAuthenticate в файле Global. asax для приложения ASP.NET.You can access the Authenticate event of the FormsAuthenticationModule class by specifying a subroutine named FormsAuthentication_OnAuthenticate in the Global.asax file for your ASP.NET application. Событие возникает во время AuthenticateRequestсобытия. AuthenticateThe Authenticate event is raised during the AuthenticateRequest event.

Конструирует объект с помощью текущего HttpContext объекта и передает его в событие FormsAuthentication_OnAuthenticate. **** FormsAuthenticationModule FormsAuthenticationEventArgsThe FormsAuthenticationModule constructs a FormsAuthenticationEventArgs object using the current HttpContext and passes it to the FormsAuthentication_OnAuthenticate event.

User IPrincipal Свойство User HttpContext **** объекта, передаваемое в событие FormsAuthentication_OnAuthenticate, можно использовать для задания свойства Current для пользовательского объекта. FormsAuthenticationEventArgsYou can use the User property of the FormsAuthenticationEventArgs object supplied to the FormsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object. Если не указать значение User свойства во время события FormsAuthentication_OnAuthenticate , будет использоваться удостоверение, предоставленное билетом проверки подлинности форм в файле cookie или URL-адресе.If you do not specify a value for the User property during the FormsAuthentication_OnAuthenticate event, the identity supplied by the forms authentication ticket in the cookie or URL is used.

Событие FormsAuthentication_OnAuthenticate возникает только в том случае, если Mode для проверки подлинности FormsAuthenticationModule задано значение Forms и является активным модулем HTTP для приложения.The FormsAuthentication_OnAuthenticate event is only raised when the authentication Mode is set to Forms and the FormsAuthenticationModule is an active HTTP module for the application.

Методы расширения

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

Применяется к

Дополнительно