WindowsAuthenticationEventArgs Klasa

Definicja

Udostępnia dane zdarzenia WindowsAuthentication_OnAuthenticate . Klasa ta nie może być dziedziczona.

public ref class WindowsAuthenticationEventArgs sealed : EventArgs
public sealed class WindowsAuthenticationEventArgs : EventArgs
type WindowsAuthenticationEventArgs = class
    inherit EventArgs
Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs
Dziedziczenie
WindowsAuthenticationEventArgs

Przykłady

Poniższy przykład kodu używa 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

Klasa WindowsAuthenticationEventArgs służy do dostarczania wartości zdarzeń do zdarzenia WindowsAuthentication_OnAuthenticate i umożliwia określenie niestandardowej tożsamości systemu Windows dla bieżącego żądania.

Obiekt WindowsAuthenticationModule tworzy WindowsAuthenticationEventArgs obiekt przy użyciu tożsamości systemu Windows dostarczonej przez usługi IIS i bieżące HttpContext i przekazuje go do zdarzenia WindowsAuthentication_OnAuthenticate .

Można użyć User właściwości obiektu dostarczonego WindowsAuthenticationEventArgs do zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy IPrincipal . Jeśli nie określisz wartości właściwości User podczas zdarzenia WindowsAuthentication_OnAuthenticate , tożsamość systemu Windows dostarczona przez usługi IIS jest używana jako tożsamość bieżącego żądania. Jeśli usługi IIS używają uwierzytelniania anonimowego, Identity właściwość jest ustawiona na tożsamość zwróconą przez metodę GetAnonymous .

Zdarzenie WindowsAuthentication_OnAuthenticate jest wywoływane tylko wtedy, gdy uwierzytelnianie Mode jest ustawione Windows i WindowsAuthenticationModule jest aktywnym modułem HTTP dla aplikacji.

Konstruktory

WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext)

Inicjuje WindowsAuthenticationEventArgs nowo utworzone wystąpienie klasy.

Właściwości

Context

HttpContext Pobiera obiekt dla bieżącego żądania HTTP.

Identity

Pobiera tożsamość systemu Windows przekazaną do konstruktora WindowsAuthenticationEventArgs .

User

Pobiera lub ustawia IPrincipal obiekt do skojarzenia z bieżącym żądaniem.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też