WindowsAuthenticationEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для события WindowsAuthentication_OnAuthenticate. Этот класс не наследуется.
public ref class WindowsAuthenticationEventArgs sealed : EventArgs
public sealed class WindowsAuthenticationEventArgs : EventArgs
type WindowsAuthenticationEventArgs = class
inherit EventArgs
Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере кода используется событие 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
Комментарии
Класс WindowsAuthenticationEventArgs используется для предоставления значений событий событию WindowsAuthentication_OnAuthenticate и для указания пользовательского удостоверения Windows для текущего запроса.
Создает WindowsAuthenticationModule объект с WindowsAuthenticationEventArgs использованием удостоверения Windows, предоставленного IIS и текущим HttpContext , и передает его в событие WindowsAuthentication_OnAuthenticate .
Вы можете использовать User свойство объекта, предоставленного WindowsAuthenticationEventArgs событию WindowsAuthentication_OnAuthenticate , чтобы задать User свойству текущего HttpContext объекта пользовательский IPrincipal объект. Если не указать значение User свойства во время события WindowsAuthentication_OnAuthenticate , удостоверение Windows, предоставленное СЛУЖБАми IIS, будет использоваться в качестве удостоверения для текущего запроса. Если СЛУЖБЫ IIS используют анонимную проверку подлинности, то свойству Identity присваивается удостоверение, возвращаемое методом GetAnonymous .
Событие WindowsAuthentication_OnAuthenticate возникает только в том случае, если для проверки подлинности Mode задано значение Windows и WindowsAuthenticationModule является активным http-модулем для приложения.
Конструкторы
WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext) |
Выполняет инициализацию нового созданного экземпляра класса WindowsAuthenticationEventArgs. |
Свойства
Context |
Возвращает объект HttpContext для текущего HTTP-запроса. |
Identity |
Возвращает удостоверение Windows, переданное конструктору WindowsAuthenticationEventArgs. |
User |
Получает или задает объект IPrincipal, который будет связан с текущим запросом. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |