FormsAuthenticationCredentials Třída
Definice
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í.
Konfiguruje přihlašovací údaje uživatele pro ASP.NET aplikace, které používají ověřování na základě formulářů.
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
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 souboru ukazuje, jak deklarativně zadat hodnoty pro credentials
oddíl.
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
V tomto příkladu se používá SHA1. Kvůli problémům s kolizí s sha1 microsoft doporučuje SHA256.
Poznámka
Pokud použijete tuto credentials
část, postupujte podle pokynů popsaných v tématu ověřování ASP.NET. Kvůli škálovatelnosti a lepšímu zabezpečení se doporučuje 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í 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žít 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 k elementu credentials
forms
oddílu v oddílu authentication
konfiguračního souboru a upravovat ho. Tento typ je součástí skupiny, která zahrnuje FormsAuthenticationConfigurationtypy , FormsAuthenticationUserCollectiona FormsAuthenticationUser . S výjimkou typu kolekce mají všechny ostatní přímý vliv na základní konfigurační značky.
Poznámka
Může FormsAuthenticationCredentials zapisovat informace do související části konfiguračního souboru v souladu s omezeními definovanými v MachineToApplication. Jakýkoli pokus o zápis do konfiguračního souboru na úrovni, která není v hierarchii povolená, způsobí, že analyzátor vygeneruje chybovou zprávu. 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 doporučujeme k zachování přihlašovacích údajů uživatelů použít externí úložiště, například databázi.
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 objekt samotný. (Zděděno od ConfigurationElement) |
EvaluationContext |
ContextInformation Získá objekt pro ConfigurationElement objekt . (Zděděno od ConfigurationElement) |
HasContext |
Získá hodnotu, která označuje, zda CurrentConfiguration je |
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) |
PasswordFormat |
Získá nebo nastaví formát hesla. |
Properties |
Získá kolekci vlastností. (Zděděno od ConfigurationElement) |
Users |
Načte jména uživatelů a přihlašovací údaje hesla. |
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á z aktuální instance. (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 jeho posledního uložení nebo načtení při implementaci v odvozené třídě. (Zděděno od ConfigurationElement) |
IsReadOnly() |
Získá hodnotu označující, zda ConfigurationElement je objekt jen pro čtení. (Zděděno od ConfigurationElement) |
ListErrors(IList) |
Přidá chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech podelementech, do předaného seznamu. (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 je zjištěn neznámý prvek 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ána po deserializaci. (Zděděno od ConfigurationElement) |
PreSerialize(XmlWriter) |
Volána 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 |
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 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) |