WindowsAuthenticationModule.Authenticate Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда приложение выполняет проверку подлинности текущего запроса.
public:
event System::Web::Security::WindowsAuthenticationEventHandler ^ Authenticate;
public event System.Web.Security.WindowsAuthenticationEventHandler Authenticate;
member this.Authenticate : System.Web.Security.WindowsAuthenticationEventHandler
Public Custom Event Authenticate As WindowsAuthenticationEventHandler
Тип события
Примеры
В следующем примере кода используется событие WindowsAuthentication_OnAuthenticate для задания User свойства текущего HttpContext пользовательского 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
Комментарии
Событие Authenticate вызывается во время AuthenticateRequest события.
Вы можете получить доступ к Authenticate событию WindowsAuthenticationModule класса, указав подзадав имя WindowsAuthentication_OnAuthenticate в файле Global.asax для приложения ASP.NET.
Свойство объекта, предоставленного WindowsAuthenticationEventArgs событию WindowsAuthentication_OnAuthenticate, можно использовать User для задания User свойства текущего HttpContext пользовательского IPrincipal объекта. Если значение свойства не указано User во время события WindowsAuthentication_OnAuthenticate , удостоверение Windows, предоставленное IIS, используется в качестве удостоверения для текущего запроса. Если СЛУЖБА IIS использует анонимную проверку подлинности, Identity то для свойства задано удостоверение, возвращаемое методом GetAnonymous .
Событие WindowsAuthentication_OnAuthenticate вызывается только в том случае, если для приложения задана Windows проверка подлинности Mode и WindowsAuthenticationModule является активным http-модулем.
Замечание
В IIS 7.0, работающем в интегрированном режиме, Authenticate событие WindowsAuthenticationModule не возникает при включении ASP.NET WindowsAuthenticationModule и модулей IIS AnonymousAuthenticationModule . В этом сценарии для получения уведомлений проверки подлинности подпишитесь на AuthenticateRequest событие экземпляра HttpApplication . Дополнительные сведения о проблемах совместимости в интегрированных режимах см. в разделе "Перемещение приложения ASP.NET из IIS 6.0 в IIS 7.0".