WindowsAuthenticationModule Klasa

Definicja

Namespace:

System.Web.Security

Montaż:

System.Web.dll

Ustawia tożsamość użytkownika dla aplikacji ASP.NET po włączeniu uwierzytelniania systemu Windows. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

WindowsAuthenticationModule

Implementuje

IHttpModule

Przykłady

W poniższym przykładzie kodu użyto zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy 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

Uwagi

Gdy uwierzytelnianie Mode jest ustawione na Windowswartość , WindowsAuthenticationModule ustawia User właściwość bieżącego HttpContext obiektu, który reprezentuje tożsamość systemu Windows dostarczaną IPrincipal przez usługi IIS dla bieżącego żądania. Jeśli usługi IIS używają uwierzytelniania anonimowego, WindowsAuthenticationModule metoda używa tożsamości zwróconej przez metodę GetAnonymous .

Obiekt WindowsAuthenticationModule uwidacznia Authenticate zdarzenie, które umożliwia podanie obiektu niestandardowego IPrincipal dla User właściwości bieżącego HttpContextobiektu . Dostęp Authenticate do zdarzenia jest uzyskiwany przez określenie podprocji o nazwie WindowsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET.

Uwaga

W usługach IIS 7.0 używanie WindowsAuthenticationModule klasy z klasą FormsAuthenticationModule nie jest obsługiwane. Aby uzyskać więcej informacji na temat problemów ze zgodnością w trybie zintegrowanym, zobacz Przenoszenie aplikacji ASP.NET z usług IIS 6.0 do usług IIS 7.0.

Konstruktorów

Nazwa	Opis
WindowsAuthenticationModule()	Tworzy wystąpienie klasy WindowsAuthenticationModule.

Metody

Nazwa	Opis
Dispose()	Zwalnia wszystkie zasoby, inne niż pamięć, używane przez program WindowsAuthenticationModule.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od Object)
Init(HttpApplication)	Inicjuje WindowsAuthenticationModule obiekt.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)

Zdarzenia

Nazwa	Opis
Authenticate	Występuje, gdy aplikacja uwierzytelnia bieżące żądanie.

Zobacz także

• Dostawca uwierzytelniania systemu Windows