FormsAuthenticationUser 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 webové aplikace, které používají ověřování na základě formulářů.
public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElement
type FormsAuthenticationUser = class
inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement
- Dědičnost
Příklady
Následující příklad kódu ukazuje, jak získat FormsAuthenticationUserCollection přístup FormsAuthenticationUser k objektům existující webové aplikace. Konfigurační soubor bude obsahovat nastavení podobné následujícímu.
Poznámka
Pokud používáte element credentials pro formuláře pro ověřování (ASP.NET schéma nastavení), nezapomeňte postupovat 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í aplikace 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="MyAppCookieName" loginUrl="/login.aspx">
defaultUrl="formsdefault.aspx"
protection="Encryption" timeout="5" path="aspnet"
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(
"/aspnet");
// Get the section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
authenticationSection.Forms.Credentials.Users;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnet")
' Get the section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the users collection.
Dim formsAuthenticationUsers _
As FormsAuthenticationUserCollection = _
authenticationSection.Forms.Credentials.Users
Poznámky
Třída FormsAuthenticationUser poskytuje způsob, jak programově přistupovat a upravovat element credentials pro formuláře pro ověřování oddílu konfiguračního souboru.
Tento typ je součástí skupiny, která zahrnuje FormsAuthenticationCredentialstypy , FormsAuthenticationUserCollectiona FormsAuthenticationConfiguration . Jiné typy než typ kolekce přímo ovlivňují základní konfigurační značky.
Poznámka
Do FormsAuthenticationUser související části konfiguračního souboru může zapisovat informace pouze na úrovni počítače, lokality nebo aplikace. Jakýkoli pokus o zápis do konfiguračního souboru na jiné úrovni v hierarchii bude mít za následek 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
FormsAuthenticationUser(String, String) |
Inicializuje novou instanci FormsAuthenticationUser třídy pomocí předaných parametrů. |
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 |
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) |
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) |
Name |
Získá nebo nastaví přihlašovací uživatelské jméno. |
Password |
Získá nebo nastaví heslo uživatele. |
Properties |
Získá kolekci vlastností. (Zděděno od ConfigurationElement) |
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 |
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) |