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