WindowsAuthenticationEventHandler Delegat

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Reprezentuje metodę, która obsługuje zdarzenie WindowsAuthentication_OnAuthenticate obiektu WindowsAuthenticationModule.

public delegate void WindowsAuthenticationEventHandler(System::Object ^ sender, WindowsAuthenticationEventArgs ^ e);

public delegate void WindowsAuthenticationEventHandler(object sender, WindowsAuthenticationEventArgs e);

type WindowsAuthenticationEventHandler = delegate of obj * WindowsAuthenticationEventArgs -> unit

Public Delegate Sub WindowsAuthenticationEventHandler(sender As Object, e As WindowsAuthenticationEventArgs)

Parametry

sender

Object

Źródło zdarzenia.

e

WindowsAuthenticationEventArgs

Element WindowsAuthenticationEventArgs zawierający dane zdarzenia.

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

Delegat WindowsAuthenticationEventHandler jest zdefiniowany dla Authenticate zdarzenia WindowsAuthenticationModule klasy. Dostęp do zdarzenia WindowsAuthenticationModule klasy można uzyskaćAuthenticate, określając podproceduty o nazwie WindowsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET. Zdarzenie Authenticate jest zgłaszane podczas AuthenticateRequest zdarzenia.

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 anonimowegoWindowsAuthenticationEventArgs, Identity właściwość obiektu 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.

Metody rozszerzania

GetMethodInfo(Delegate)

Pobiera obiekt reprezentujący metodę reprezentowaną przez określonego delegata.

Zobacz też

• Dostawca uwierzytelniania systemu Windows