DefaultAuthenticationModule Třída

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Zajišťuje, že objekt ověřování je přítomen v kontextu. Tato třída se nemůže dědit.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

Dědičnost

Object

DefaultAuthenticationModule

Implementuje

IHttpModule

Příklady

Následující příklad používá událost DefaultAuthentication_OnAuthenticate k otestování, zda User je nullvlastnost aktuální HttpContext instance . User Pokud je nullvlastnost , pak ukázka nastaví User vlastnost aktuální HttpContext instance na GenericPrincipal objekt, kde Identity hodnota objektu GenericPrincipal je GenericIdentity s Name hodnotou "default".

Poznámka

Událost DefaultAuthentication_OnAuthenticate je vyvolána před událostí AuthorizeRequest . V důsledku toho, pokud nastavíte User vlastnost aktuální HttpContext instance na vlastní identitu, může to ovlivnit chování vaší aplikace. Pokud například používáte FormsAuthentication třídu a v části konfigurace autorizace zadáte<deny users="?" />, abyste zajistili, že přístup k vašemu webu budou mít jenom ověření uživatelé, tato ukázka způsobí ignorování elementu deny, protože uživatel bude mít název, který je "výchozí". Místo toho byste zadali<deny users="default" />, aby k webu měli přístup jenom ověření uživatelé.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}

Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Poznámky

Zajišťuje DefaultAuthenticationModule , že User vlastnost aktuální HttpContext instance je nastavena IPrincipal na objekt pro každý požadavek. Objekt DefaultAuthenticationModule zkoumá vlastnost po AuthenticateRequest události a před událostí AuthorizeRequestUser. User Pokud je nullvlastnost , DefaultAuthenticationModule nastaví User vlastnost na GenericPrincipal objekt, který neobsahuje žádné informace o uživateli.

Pokud ověřovací modul nastaví StatusCode vlastnost na 401, vykreslí DefaultAuthenticationModule chybovou stránku odepření přístupu. Pokud je hodnota StatusCode vlastnosti nastavena na hodnotu větší než 200, DefaultAuthenticationModule objekt ukončí požadavek. V takovém případě se před dokončením aktuálního požadavku volají pouze moduly HTTP, které se přihlásí k odběru EndRequest události.

Authenticate Zveřejňuje DefaultAuthenticationModule událost. Tuto událost můžete použít k zadání vlastního IPrincipal objektu User pro vlastnost aktuální HttpContext instance. K Authenticate události se přistupuje zadáním události s názvem DefaultAuthentication_OnAuthenticate v souboru Global.asax aplikace.

Konstruktory

DefaultAuthenticationModule()

Inicializuje novou instanci DefaultAuthenticationModule třídy .

Metody

Dispose()	Uvolní všechny prostředky kromě paměti, které DefaultAuthenticationModulepoužívá .
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)
Init(HttpApplication)	Inicializuje DefaultAuthenticationModule objekt .
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)

Událost

Authenticate

Vyvolá se po ověření požadavku.

Viz také

• Ověřování pomocí technologie ASP.NET