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
Комментарии
Если для проверки подлинности Mode задано значение Windows, WindowsAuthenticationModule свойство текущего HttpContextIPrincipal объекта задает User объект , представляющий удостоверение Windows, предоставленное службами IIS для текущего запроса. Если СЛУЖБЫ IIS используют анонимную проверку подлинности, то WindowsAuthenticationModule использует удостоверение, возвращенное методом GetAnonymous .
объект WindowsAuthenticationModule предоставляет Authenticate событие, позволяющее предоставить пользовательский IPrincipal объект для User свойства текущего HttpContextобъекта . Доступ Authenticate к событию осуществляется путем указания подпрограммы с именем WindowsAuthentication_OnAuthenticate в файле Global.asax для приложения ASP.NET.
Примечание
В IIS 7.0 использование WindowsAuthenticationModule класса с классом FormsAuthenticationModule не поддерживается. Дополнительные сведения о проблемах совместимости в интегрированном режиме см. в статье Перемещение приложения 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 |
Происходит, когда приложение выполняет проверку подлинности текущего запроса. |