DefaultAuthenticationModule Třída

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Zajišťuje, aby objekt ověřování byl v kontextu. Tuto třídu nelze zdě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á DefaultAuthentication_OnAuthenticate událost testovat, zda User vlastnost aktuální HttpContext instance je null. Pokud je nullvlastnost , pak ukázka nastaví User vlastnost aktuální HttpContext instance na GenericPrincipal objekt, kde IdentityGenericPrincipal je objekt s GenericIdentityName hodnotou "výchozí".User

Poznámka:

Událost DefaultAuthentication_OnAuthenticate je vyvolána před událostí AuthorizeRequest . Pokud nastavíte User vlastnost aktuální HttpContext instance na vlastní identitu, může to mít vliv na chování vaší aplikace. Pokud například používáte třídu a v oddílu FormsAuthentication konfigurace autorizace zadáte<deny users="?" />, aby k vašemu webu měli přístup jenom ověření uživatelé, tato ukázka způsobí ignorování elementu zamítnutí, protože uživatel bude mít jméno, což je "výchozí". Místo toho byste určili<deny users="default" />, že k vašemu webu budou mít 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 na IPrincipal objekt pro každý požadavek. Zkontroluje DefaultAuthenticationModuleUser vlastnost po AuthenticateRequest události a před událostí AuthorizeRequest . 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, DefaultAuthenticationModule vykreslí 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 EndRequest odběru události.

Zpřístupňuje DefaultAuthenticationModuleAuthenticate událost. Tuto událost můžete použít k poskytnutí 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

Name	Description
DefaultAuthenticationModule()	Inicializuje novou instanci DefaultAuthenticationModule třídy.

Metody

Name	Description
Dispose()	Uvolní všechny prostředky kromě paměti používané nástrojem DefaultAuthenticationModule.
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 DefaultAuthenticationModule 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 po ověření požadavku.

Viz také

• ověřování ASP.NET