FormsAuthenticationCredentials 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 přihlašovací údaje uživatele pro ASP.NET aplikace, které používají ověřování založené na formuláři.

public ref class FormsAuthenticationCredentials sealed : System::Configuration::ConfigurationElement

public sealed class FormsAuthenticationCredentials : System.Configuration.ConfigurationElement

type FormsAuthenticationCredentials = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationCredentials
Inherits ConfigurationElement

Dědičnost: Object

ConfigurationElement
FormsAuthenticationCredentials

Příklady

Tento příklad ukazuje, jak zadat hodnoty deklarativní pro několik atributů oddílu credentials , ke kterým lze přistupovat také jako členové FormsAuthenticationCredentials třídy.

Následující příklad konfiguračního credentials souboru ukazuje, jak zadat hodnoty deklarativní pro oddíl.

<credentials passwordFormat="SHA1">
  <user name="aspnetuser1"
    password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
  <user name="aspnetuser2"
    password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>

Tento příklad používá SHA1. Kvůli problémům se kolizemi s SHA1 doporučuje Microsoft SHA256.

Poznámka

Pokud používáte credentials tuto část, nezapomeňte postupovat podle pokynů popsaných v tématu ASP.NET Ověřování. Pro zajištění škálovatelnosti a lepšího zabezpečení se doporučuje použít externí databázi k uložení přihlašovacích údajů uživatelů. Další informace o vytváření zabezpečených ASP.NET aplikací najdete v tématu Zabezpečení aplikace ASP.NET a vytváření zabezpečených ASP.NET aplikací: ověřování, autorizace a zabezpečená komunikace.

Následující příklad kódu ukazuje, jak používat FormsAuthenticationCredentials třídu.


// Get the Web application configuration.
System.Configuration.Configuration configuration = 
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

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

// Get the forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
    authenticationSection.Forms.Credentials;

' Get the Web application configuration.
  Dim configuration As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

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

' Get the forms credentials collection .
  Dim formsAuthenticationCredentials _
  As FormsAuthenticationCredentials = _
  authenticationSection.Forms.Credentials

Poznámky

Třída FormsAuthenticationCredentials poskytuje způsob, jak programově přistupovat a upravovat credentials prvek forms oddílu v authentication oddílu konfiguračního souboru. Tento typ je součástí skupiny, která obsahuje FormsAuthenticationConfiguration, a FormsAuthenticationUserCollection FormsAuthenticationUser typy. S výjimkou typu kolekce ovlivňují všechny ostatní přímo základní konfigurační značky.

Poznámka

Může FormsAuthenticationCredentials zapisovat informace do související části konfiguračního souboru podle omezení definovaných 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. Pro zajištění bezpečnosti a škálovatelnosti se doporučuje používat externí úložiště, jako je databáze, k zachování přihlašovacích údajů uživatelů.

Konstruktory

FormsAuthenticationCredentials()

Inicializuje novou instanci FormsAuthenticationCredentials třídy.

Vlastnosti

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)
ElementInformation	ElementInformation Získá objekt, který obsahuje neuzpůsobitelné informace a funkce objektuConfigurationElement. (Zděděno od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Získá objekt, který představuje ConfigurationElement samotný objekt. (Zděděno od ConfigurationElement)
EvaluationContext	ContextInformation Získá objekt objektuConfigurationElement. (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 konfiguračního prvku. (Zděděno od ConfigurationElement)
Item[String]	Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto konfiguračního prvku. (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 určující, zda je prvek uzamčen. (Zděděno od ConfigurationElement)
PasswordFormat	Získá nebo nastaví formát hesla.
Properties	Získá kolekci vlastností. (Zděděno od ConfigurationElement)
Users	Získá jména uživatelů a přihlašovací údaje k heslem.

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()	Type Získá aktuální instanci. (Zděděno od Object)
Init()	ConfigurationElement Nastaví objekt na počáteční stav. (Zděděno od ConfigurationElement)
InitializeDefault()	Slouží k inicializaci výchozí sady hodnot objektu ConfigurationElement . (Zděděno od ConfigurationElement)
IsModified()	Označuje, zda byl tento element konfigurace změněn od posledního uložení nebo načtení, při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
IsReadOnly()	Získá hodnotu určující, zda ConfigurationElement objekt je jen pro čtení. (Zděděno od ConfigurationElement)
ListErrors(IList)	Přidá chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech dílčích počtech do předaného seznamu. (Zděděno od ConfigurationElement)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (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 je při deserializaci zjištěn neznámý prvek. (Zděděno od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Vyvolá výjimku, když se nenajde 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)	Obnoví vnitřní stav objektu ConfigurationElement , včetně zámků a kolekcí vlastností. (Zděděno od ConfigurationElement)
ResetModified()	Obnoví 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 konfiguračního prvku 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 pro ConfigurationElement objekt a všechny dílčí prvky. (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