WindowsAuthenticationModule Classe

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll

Define a identidade do utilizador para uma aplicação ASP.NET quando a Windows authentication está ativada. Esta 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
Object
WindowsAuthenticationModule
Implementações
IHttpModule

Exemplos

O exemplo de código seguinte utiliza o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext para 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

Observações

Quando a autenticação Mode é definida para Windows, a WindowsAuthenticationModule define a propriedade User do atual HttpContext para um objeto IPrincipal que representa a identidade Windows fornecida pelo IIS para o pedido atual. Se o IIS usar autenticação anónima, então WindowsAuthenticationModule utiliza a identidade devolvida pelo GetAnonymous método.

O WindowsAuthenticationModule evento expõe um Authenticate evento que lhe permite fornecer um objeto personalizado IPrincipal para a User propriedade do atual HttpContext. O evento Authenticate é acedido especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no ficheiro Global.asax da sua aplicação de ASP.NET.

Note

No IIS 7.0, o uso da WindowsAuthenticationModule classe com a FormsAuthenticationModule classe não é suportado. Para mais informações sobre questões de compatibilidade no modo Integrado, consulte Moving an ASP.NET Application do IIS 6.0 para o IIS 7.0.

Construtores

Name Description
WindowsAuthenticationModule()

Cria uma instância da WindowsAuthenticationModule classe.

Métodos

Name Description
Dispose()

Liberta todos os recursos, exceto memória, usados pelo WindowsAuthenticationModule.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(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 atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
Authenticate

Ocorre quando a aplicação autentica o pedido atual.

Aplica-se a

Ver também