WindowsAuthenticationModule Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает удостоверение пользователя для приложения ASP.NET при включении проверки подлинности Windows. Этот класс не может быть унаследован.
public ref class WindowsAuthenticationModule sealed : System::Web::IHttpModule
public sealed class WindowsAuthenticationModule : System.Web.IHttpModule
type WindowsAuthenticationModule = class
interface IHttpModule
Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule
- Наследование
-
WindowsAuthenticationModule
- Реализации
Примеры
В следующем примере кода используется событие 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
Комментарии
Если для проверки подлинности задано Windowsзначение, UserWindowsAuthenticationModule свойство текущего HttpContextIPrincipal объекта, представляющего удостоверение Windows, предоставленное IIS для текущего запроса.Mode Если СЛУЖБА IIS использует анонимную проверку подлинности, использует удостоверение, WindowsAuthenticationModule возвращаемое методом GetAnonymous .
Предоставляет WindowsAuthenticationModule событие, позволяющее предоставить пользовательский IPrincipal объект для User свойства текущегоHttpContext.Authenticate Доступ Authenticate к событию осуществляется путем указания подзадачей с именем WindowsAuthentication_OnAuthenticate в файле Global.asax для приложения ASP.NET.
Замечание
В IIS 7.0 использование класса с классом WindowsAuthenticationModuleFormsAuthenticationModule не поддерживается. Дополнительные сведения о проблемах совместимости в интегрированном режиме см. в разделе "Перемещение приложения ASP.NET из IIS 6.0 в IIS 7.0".
Конструкторы
| Имя | Описание |
|---|---|
| WindowsAuthenticationModule() |
Создает экземпляр класса WindowsAuthenticationModule. |
Методы
| Имя | Описание |
|---|---|
| Dispose() |
Освобождает все ресурсы, отличные от памяти, используемой параметром WindowsAuthenticationModule. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Init(HttpApplication) |
Инициализирует объект WindowsAuthenticationModule. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
| Имя | Описание |
|---|---|
| Authenticate |
Происходит, когда приложение выполняет проверку подлинности текущего запроса. |