FormsAuthenticationModule Classe

Definição

Define a identidade do usuário para um aplicativo ASP.NET quando a autenticação de formulários está habilitada.Sets the identity of the user for an ASP.NET application when forms authentication is enabled. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class FormsAuthenticationModule sealed : System::Web::IHttpModule
public sealed class FormsAuthenticationModule : System.Web.IHttpModule
type FormsAuthenticationModule = class
    interface IHttpModule
Public NotInheritable Class FormsAuthenticationModule
Implements IHttpModule
Herança
FormsAuthenticationModule
Implementações

Exemplos

O exemplo a seguir usa o evento FormsAuthentication_OnAuthenticate para definir a User Propriedade do atual HttpContext como um IPrincipal objeto personalizado.The following example uses the FormsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object.

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

Comentários

O FormsAuthenticationModule define a HttpContext.User propriedade atual como um IPrincipal objeto que representa a identidade do usuário para a solicitação atual quando a autenticação Mode é definida como no elemento do Forms elemento de autenticação (esquema de configurações do ASP.net) do arquivo de configuração do aplicativo.The FormsAuthenticationModule sets the current HttpContext.User property to an IPrincipal object that represents the user identity for the current request when the authentication Mode is set to Forms in the authentication Element (ASP.NET Settings Schema) element of the application's configuration file.

O FormsAuthenticationModule expõe um Authenticate evento que permite que você forneça um IPrincipal objeto personalizado para a User Propriedade do atual HttpContext .The FormsAuthenticationModule exposes an Authenticate event that enables you to provide a custom IPrincipal object for the User property of the current HttpContext. O Authenticate evento é acessado especificando uma sub-rotina chamada FormsAuthentication_OnAuthenticate no arquivo global. asax para seu aplicativo ASP.net.The Authenticate event is accessed by specifying a subroutine named FormsAuthentication_OnAuthenticate in the Global.asax file for your ASP.NET application.

Observação

No IIS 7,0, WindowsAuthenticationModule FormsAuthenticationModule não há suporte para o usando o com o.In IIS 7.0, using the WindowsAuthenticationModule with the FormsAuthenticationModule is not supported. Para obter mais informações sobre problemas de compatibilidade em modos integrados, consulte movendo um aplicativo ASP.net do iis 6,0 para o iis 7,0.For more information about compatibility issues in Integrated modes, see Moving an ASP.NET Application from IIS 6.0 to IIS 7.0.

Construtores

FormsAuthenticationModule()

Inicializa uma nova instância da classe FormsAuthenticationModule.Initializes a new instance of the FormsAuthenticationModule class.

Métodos

Dispose()

Libera todos os recursos, exceto a memória, usados pelo FormsAuthenticationModule.Releases all resources, other than memory, used by the FormsAuthenticationModule.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
Init(HttpApplication)

Inicializa o objeto FormsAuthenticationModule.Initializes the FormsAuthenticationModule object.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Eventos

Authenticate

Ocorre quando o aplicativo autentica a solicitação atual.Occurs when the application authenticates the current request.

Aplica-se a