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.
Свойство объекта, предоставленного User событию WindowsAuthenticationEventArgs, можно использовать для задания User свойства текущего HttpContext пользовательского IPrincipal объекта. Если значение свойства не указано User во время события WindowsAuthentication_OnAuthenticate , удостоверение Windows, предоставленное IIS, используется в качестве удостоверения для текущего запроса. Если СЛУЖБА IIS использует анонимную проверку подлинности, Identity то для свойства задано удостоверение, возвращаемое методом GetAnonymous .
Событие WindowsAuthentication_OnAuthenticate вызывается только в том случае, если для приложения задана Mode проверка подлинности Windows и WindowsAuthenticationModule является активным http-модулем.
Note
В IIS 7.0, работающем в интегрированном режиме, Authenticate событие WindowsAuthenticationModule не возникает при включении ASP.NET WindowsAuthenticationModule и модулей IIS AnonymousAuthenticationModule . В этом сценарии для получения уведомлений проверки подлинности подпишитесь на AuthenticateRequest событие экземпляра HttpApplication . Дополнительные сведения о проблемах совместимости в интегрированных режимах см. в разделе "Перемещение приложения ASP.NET из IIS 6.0 в IIS 7.0".