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í HttpContext na vlastní IPrincipal objekt.
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 slouží k zadání hodnot událostí WindowsAuthentication_OnAuthenticate události a umožňuje zadat vlastní Windows identitu pro aktuální požadavek.
WindowsAuthenticationEventArgs Vytvoří WindowsAuthenticationModule objekt pomocí Windows identity poskytované službou IIS a aktuální HttpContext a předá ho události WindowsAuthentication_OnAuthenticate.
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 User vlastnosti, použije se Windows identita 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é na Windows a WindowsAuthenticationModule je aktivním modulem HTTP pro aplikaci.
Konstruktory
WindowsAuthenticationEventArgs(WindowsIdentity, HttpContext) |
Inicializuje nově vytvořenou WindowsAuthenticationEventArgs instanci třídy. |
Vlastnosti
Context |
HttpContext Získá objekt pro aktuální požadavek HTTP. |
Identity |
Získá Windows identitu předanou konstruktoruWindowsAuthenticationEventArgs. |
User |
Získá nebo nastaví IPrincipal objekt, který má být přidružen k aktuálnímu požadavku. |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |