WindowsAuthenticationModule 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í.
Nastaví identitu uživatele pro aplikaci ASP.NET, když je povolené ověřování systému Windows. Tuto třídu nelze zdědit.
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
- Dědičnost
-
WindowsAuthenticationModule
- Implementuje
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
Pokud je ověřování Mode nastaveno na Windows, WindowsAuthenticationModule nastaví User vlastnost aktuální HttpContext na IPrincipal objekt, který představuje identitu systému Windows poskytnutou službou IIS pro aktuální požadavek. Pokud služba IIS používá anonymní ověřování, WindowsAuthenticationModule použije identitu vrácenou metodou GetAnonymous .
Zveřejňuje WindowsAuthenticationModuleAuthenticate událost, která umožňuje poskytnout vlastní IPrincipal objekt pro User vlastnost aktuálního HttpContext. K Authenticate události se přistupuje zadáním podprogramu s názvem WindowsAuthentication_OnAuthenticate v souboru Global.asax pro vaši ASP.NET aplikaci.
Poznámka:
Ve službě IIS 7.0 není použití WindowsAuthenticationModule třídy s FormsAuthenticationModule třídou podporováno. Další informace o problémech s kompatibilitou v integrovaném režimu najdete v tématu Přesunutí aplikace ASP.NET ze služby IIS 6.0 do služby IIS 7.0.
Konstruktory
| Name | Description |
|---|---|
| WindowsAuthenticationModule() |
Vytvoří instanci objektu WindowsAuthenticationModule třídy. |
Metody
| Name | Description |
|---|---|
| Dispose() |
Uvolní všechny prostředky kromě paměti používané nástrojem WindowsAuthenticationModule. |
| 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) |
| Init(HttpApplication) |
Inicializuje WindowsAuthenticationModule objekt. |
| 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) |
Událost
| Name | Description |
|---|---|
| Authenticate |
Nastane, když aplikace ověří aktuální požadavek. |