Sdílet prostřednictvím


FormsAuthenticationConfiguration Třída

Definice

Nakonfiguruje aplikaci ASP.NET tak, aby používala AuthenticationMode modily formulářů.

public ref class FormsAuthenticationConfiguration sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElement
type FormsAuthenticationConfiguration = class
    inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement
Dědičnost
FormsAuthenticationConfiguration

Příklady

Následující příklad kódu ukazuje, jak získat FormsAuthenticationConfiguration objekt z konfiguračního souboru existující webové aplikace. Tento objekt můžete použít pro přístup k jeho členům. Konfigurační soubor bude obsahovat nastavení podobné následujícímu.

Poznámka Pokud použijete tuto credentials část, postupujte podle pokynů popsaných v tématu ověřování ASP.NET. Pro zajištění škálovatelnosti a lepšího zabezpečení doporučujeme k ukládání přihlašovacích údajů uživatelů použít externí databázi. Další informace o vytváření zabezpečených ASP.NET aplikací najdete v tématech Zabezpečení aplikací ASP.NET a Vytváření zabezpečených ASP.NET aplikací: Ověřování, autorizace a zabezpečená komunikace.

V tomto příkladu se používá SHA1. Kvůli problémům s kolizí s SHA1 microsoft doporučuje SHA256.

<authentication mode="Forms">
  <forms name="MyAppCookie" loginUrl="login.aspx"
    defaultUrl="default.aspx"
    protection="Encryption" timeout="5" path="aspnetTest"
    slidingExpiration="false"
    cookieless="UseCookies" domain="domainName">
    <credentials passwordFormat="SHA1">
      <user name="aspnetuser1"
        password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
       <user name="aspnetuser2"
         password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
    </credentials>
  </forms>
</authentication>
// Get the Web application configuration.
System.Configuration.Configuration configuration = 
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the external Authentication section.
AuthenticationSection authenticationSection = 
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");

// Get the external Forms section .
FormsAuthenticationConfiguration formsAuthentication =
    authenticationSection.Forms;
' Get the Web application configuration.
  Dim configuration As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

' Get the external Authentication section.
  Dim authenticationSection _
  As AuthenticationSection = _
  CType(configuration.GetSection( _
  "system.web/authentication"), AuthenticationSection)

' Get the external Forms section .
  Dim formsAuthentication _
  As FormsAuthenticationConfiguration = _
  authenticationSection.Forms

Poznámky

Třída FormsAuthenticationConfiguration poskytuje způsob, jak programově přistupovat k elementu forms konfiguračního authentication oddílu a upravovat ho.

Tento typ je součástí skupiny, která zahrnuje FormsAuthenticationCredentialstypy , FormsAuthenticationUserCollectiona FormsAuthenticationUser . Jiné typy než typ kolekce přímo ovlivňují základní konfigurační značky.

Poznámka

Může FormsAuthenticationConfiguration zapisovat informace do související části konfiguračního souboru podle omezení definovaných vlastností AllowDefinition section, jejíž hodnota je MachineToApplication. Jakýkoli pokus o zápis do konfiguračního souboru na úrovni, která není v hierarchii povolená, způsobí chybovou zprávu vygenerovanou analyzátorem. Tuto třídu však můžete použít ke čtení informací o konfiguraci na libovolné úrovni v hierarchii. Z důvodu bezpečnosti a škálovatelnosti se k uchování přihlašovacích údajů uživatelů doporučuje použít externí úložiště, například databázi.

Konstruktory

FormsAuthenticationConfiguration()

Inicializuje novou instanci FormsAuthenticationConfiguration třídy.

Vlastnosti

Cookieless

Získá nebo nastaví hodnotu určující, zda má ověřování založené na formulářích používat soubory cookie.

CookieSameSite

Získá nebo nastaví hodnotu pro Atribut SameSite souboru cookie.

Credentials

Získá kolekci FormsAuthenticationCredentials uživatelských jmen a hesel.

CurrentConfiguration

Získá odkaz na instanci nejvyšší úrovně Configuration , která představuje hierarchii konfigurace, do které aktuální ConfigurationElement instance patří.

(Zděděno od ConfigurationElement)
DefaultUrl

Získá nebo nastaví výchozí adresu URL.

Domain

Získá nebo nastaví název domény, který se má odeslat pomocí ověřovacích souborů cookie formulářů.

ElementInformation

Získá ElementInformation objekt, který obsahuje přizpůsobitelné informace a funkce objektu ConfigurationElement .

(Zděděno od ConfigurationElement)
ElementProperty

ConfigurationElementProperty Získá objekt, který představuje ConfigurationElement samotný objekt.

(Zděděno od ConfigurationElement)
EnableCrossAppRedirects

Získá nebo nastaví hodnotu určující, zda ověřené uživatele lze přesměrovat na adresy URL v jiných aplikacích.

EvaluationContext

ContextInformation Získá objekt pro ConfigurationElement objekt.

(Zděděno od ConfigurationElement)
HasContext

Získá hodnotu, která označuje, zda CurrentConfiguration je nullvlastnost .

(Zděděno od ConfigurationElement)
Item[ConfigurationProperty]

Získá nebo nastaví vlastnost nebo atribut tohoto elementu konfigurace.

(Zděděno od ConfigurationElement)
Item[String]

Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto elementu konfigurace.

(Zděděno od ConfigurationElement)
LockAllAttributesExcept

Získá kolekci uzamčených atributů.

(Zděděno od ConfigurationElement)
LockAllElementsExcept

Získá kolekci uzamčených prvků.

(Zděděno od ConfigurationElement)
LockAttributes

Získá kolekci uzamčených atributů.

(Zděděno od ConfigurationElement)
LockElements

Získá kolekci uzamčených prvků.

(Zděděno od ConfigurationElement)
LockItem

Získá nebo nastaví hodnotu označující, zda je prvek uzamčen.

(Zděděno od ConfigurationElement)
LoginUrl

Získá nebo nastaví adresu URL přesměrování pro požadavek.

Name

Získá nebo nastaví název souboru cookie.

Path

Získá nebo nastaví cestu k souboru cookie.

Properties

Získá kolekci vlastností.

(Zděděno od ConfigurationElement)
Protection

Získá nebo nastaví typ šifrování použitý k šifrování souboru cookie.

RequireSSL

Získá nebo nastaví hodnotu určující, zda se při přenosu ověřovacích informací vyžaduje připojení SSL (Secure Sockets Layer).

SlidingExpiration

Získá nebo nastaví klouzavé vypršení platnosti ověřování.

TicketCompatibilityMode

Získá nebo nastaví hodnotu, která označuje, zda použít koordinovaný univerzální čas (UTC) nebo místní čas pro datum vypršení platnosti lístku.

Timeout

Získá nebo nastaví časový limit ověřování.

Metody

DeserializeElement(XmlReader, Boolean)

Načte XML z konfiguračního souboru.

(Zděděno od ConfigurationElement)
Equals(Object)

Porovná aktuální ConfigurationElement instanci se zadaným objektem.

(Zděděno od ConfigurationElement)
GetHashCode()

Získá jedinečnou hodnotu představující aktuální ConfigurationElement instanci.

(Zděděno od ConfigurationElement)
GetTransformedAssemblyString(String)

Vrátí transformovanou verzi zadaného názvu sestavení.

(Zděděno od ConfigurationElement)
GetTransformedTypeString(String)

Vrátí transformovanou verzi zadaného názvu typu.

(Zděděno od ConfigurationElement)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
Init()

ConfigurationElement Nastaví objekt do počátečního stavu.

(Zděděno od ConfigurationElement)
InitializeDefault()

Slouží k inicializaci výchozí sady hodnot objektu ConfigurationElement .

(Zděděno od ConfigurationElement)
IsModified()

Určuje, zda byl tento konfigurační prvek změněn od posledního uložení nebo načtení, když byl implementován v odvozené třídě.

(Zděděno od ConfigurationElement)
IsReadOnly()

Získá hodnotu označující, zda ConfigurationElement objekt je jen pro čtení.

(Zděděno od ConfigurationElement)
ListErrors(IList)

Přidá do předaného seznamu chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech dílčích pomůcecích.

(Zděděno od ConfigurationElement)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
OnDeserializeUnrecognizedAttribute(String, String)

Získá hodnotu označující, zda je zjištěn neznámý atribut během deserializace.

(Zděděno od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Získá hodnotu označující, zda neznámý prvek je nalezen během deserializace.

(Zděděno od ConfigurationElement)
OnRequiredPropertyNotFound(String)

Vyvolá výjimku, pokud není nalezena požadovaná vlastnost.

(Zděděno od ConfigurationElement)
PostDeserialize()

Volá se po deserializaci.

(Zděděno od ConfigurationElement)
PreSerialize(XmlWriter)

Volá se před serializací.

(Zděděno od ConfigurationElement)
Reset(ConfigurationElement)

Resetuje vnitřní stav objektu ConfigurationElement , včetně zámků a kolekcí vlastností.

(Zděděno od ConfigurationElement)
ResetModified()

Resetuje hodnotu IsModified() metody na false při implementaci v odvozené třídě.

(Zděděno od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Zapíše obsah tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě.

(Zděděno od ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Zapíše vnější značky tohoto elementu konfigurace do konfiguračního souboru při implementaci v odvozené třídě.

(Zděděno od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Nastaví vlastnost na zadanou hodnotu.

(Zděděno od ConfigurationElement)
SetReadOnly()

IsReadOnly() Nastaví vlastnost objektu ConfigurationElement a všech dílčích elementů.

(Zděděno od ConfigurationElement)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Upraví objekt tak, ConfigurationElement aby odebral všechny hodnoty, které by neměly být uloženy.

(Zděděno od ConfigurationElement)

Platí pro

Viz také