WindowsAuthenticationEventArgs Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje data pro událost WindowsAuthentication_OnAuthenticate . Tuto třídu nelze zdědit.
public ref class WindowsAuthenticationEventArgs sealed : EventArgs
public sealed class WindowsAuthenticationEventArgs : EventArgs
type WindowsAuthenticationEventArgs = class
inherit EventArgs
Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs
- Dědičnost
Příklady
Následující příklad kódu používá WindowsAuthentication_OnAuthenticate událost k nastavení User vlastnosti aktuálního HttpContext objektu 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
Poznámky
Třída WindowsAuthenticationEventArgs se používá k zadání hodnot událostí do události WindowsAuthentication_OnAuthenticate a k povolení zadání vlastní identity systému Windows pro aktuální požadavek.
WindowsAuthenticationEventArgs Vytvoří WindowsAuthenticationModule objekt pomocí identity systému Windows poskytnuté službou IIS a aktuální HttpContext a předá ho WindowsAuthentication_OnAuthenticate události.
Vlastnost objektu WindowsAuthenticationEventArgs zadaného do události WindowsAuthentication_OnAuthenticate můžete použít User k nastavení User vlastnosti aktuálního HttpContext objektu na vlastní IPrincipal objekt. Pokud během události WindowsAuthentication_OnAuthenticate nezadáte hodnotu vlastnostiUser, použije se identita systému Windows zadaná službou IIS jako identita pro aktuální požadavek. Pokud služba IIS používá anonymní ověřování, Identity vlastnost je nastavena na identitu vrácenou metodou GetAnonymous .
Událost WindowsAuthentication_OnAuthenticate se vyvolá pouze v případě, že je ověřování Mode nastavené Windows na a WindowsAuthenticationModule je aktivním modulem HTTP pro aplikaci.
Konstruktory
| Name | Description |
|---|---|
| WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext) |
Inicializuje nově vytvořenou WindowsAuthenticationEventArgs instanci třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Context |
HttpContext Získá objekt pro aktuální požadavek HTTP. |
| Identity |
Získá identitu systému Windows předanou konstruktoru WindowsAuthenticationEventArgs . |
| User |
Získá nebo nastaví IPrincipal objekt, který má být přidružen k aktuálnímu požadavku. |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |