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 . Tato třída se nemůže dě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á událost WindowsAuthentication_OnAuthenticate 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 se používá k poskytování hodnot událostí WindowsAuthentication_OnAuthenticate události a k tomu, abyste mohli zadat vlastní identitu systému Windows pro aktuální požadavek.
Vytvoří WindowsAuthenticationModuleWindowsAuthenticationEventArgs objekt pomocí identity systému Windows poskytované službou IIS a aktuální HttpContext a předá jej události WindowsAuthentication_OnAuthenticate .
Pomocí vlastnosti objektu zadaného WindowsAuthenticationEventArgsdo události WindowsAuthentication_OnAuthenticate můžete User nastavit User vlastnost aktuálního HttpContext objektu na vlastní IPrincipal objekt. Pokud nezadáte hodnotu User vlastnosti během události WindowsAuthentication_OnAuthenticate , použije se identita systému Windows poskytovaná službou IIS jako identita pro aktuální požadavek. Pokud služba IIS používá anonymní ověřování, Identity je vlastnost nastavena na identitu vrácenou metodou GetAnonymous .
Událost WindowsAuthentication_OnAuthenticate je vyvolána pouze v případě, že je ověřování Mode nastaveno 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á 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
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |