FormsAuthenticationConfiguration Třída

Reference

Definice

Obor názvů:: System.Web.Configuration

Sestavení:: System.Web.dll

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í.

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: Object

ConfigurationElement
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 `null`vlastnost . (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

Sdílet prostřednictvím