WindowsAuthenticationEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Dostarcza dane dla 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

Object

EventArgs

WindowsAuthenticationEventArgs

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

Klasa WindowsAuthenticationEventArgs służy do podawania 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 oraz bieżącego HttpContext i przekazuje go do zdarzenia WindowsAuthentication_OnAuthenticate .

Możesz 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 będzie 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 zgłaszane tylko wtedy, gdy uwierzytelnianie Mode jest ustawione na 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, który ma być skojarzony 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 wartość bieżącego wystąpienia. (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)

Zobacz też

• Dostawca uwierzytelniania systemu Windows