WindowsAuthenticationModule Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define a identidade do usuário para um aplicativo ASP.NET quando a autenticação do Windows está habilitada. Essa classe não pode ser herdada.
public ref class WindowsAuthenticationModule sealed : System::Web::IHttpModule
public sealed class WindowsAuthenticationModule : System.Web.IHttpModule
type WindowsAuthenticationModule = class
interface IHttpModule
Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule
- Herança
-
WindowsAuthenticationModule
- Implementações
Exemplos
O exemplo de código a seguir usa o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext como um objeto personalizado IPrincipal .
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
If Not args.Identity.IsAnonymous Then
args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
End If
End Sub
Comentários
Quando a autenticação Mode é definida como Windows, o WindowsAuthenticationModule define a User propriedade do atual HttpContext como um IPrincipal objeto que representa a identidade do Windows fornecida pelo IIS para a solicitação atual. Se o IIS usar autenticação anônima, o WindowsAuthenticationModule usará a identidade retornada pelo GetAnonymous método .
O WindowsAuthenticationModule expõe um Authenticate evento que permite que você forneça um objeto personalizado IPrincipal para a User propriedade do atual HttpContext. O Authenticate evento é acessado especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no arquivo Global.asax para seu aplicativo ASP.NET.
Observação
No IIS 7.0, não há suporte para o uso da WindowsAuthenticationModule classe com a FormsAuthenticationModule classe . Para obter mais informações sobre problemas de compatibilidade no modo integrado, consulte Movendo um aplicativo de ASP.NET do IIS 6.0 para o IIS 7.0.
Construtores
WindowsAuthenticationModule() |
Cria uma instância de WindowsAuthenticationModule classe. |
Métodos
Dispose() |
Libera todos os recursos, exceto a memória, usados pelo WindowsAuthenticationModule. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
Init(HttpApplication) |
Inicializa o objeto WindowsAuthenticationModule. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Eventos
Authenticate |
Ocorre quando o aplicativo autentica a solicitação atual. |