FormsAuthenticationConfiguration Klasa

Definicja

Namespace:

System.Web.Configuration

Montaż:

System.Web.dll

Konfiguruje aplikację ASP.NET do używania modalności formularzy AuthenticationMode.

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

Dziedziczenie

Object

ConfigurationElement

FormsAuthenticationConfiguration

Przykłady

Poniższy przykład kodu pokazuje, jak uzyskać obiekt FormsAuthenticationConfiguration z pliku konfiguracji istniejącej aplikacji internetowej. Tego obiektu można użyć do uzyskiwania dostępu do jego elementów członkowskich.

// 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

Uwagi

Klasa FormsAuthenticationConfiguration umożliwia programowy dostęp i modyfikowanie elementu forms sekcji authentication konfiguracji.

Ten typ jest częścią grupy, która zawiera FormsAuthenticationCredentials, FormsAuthenticationUserCollectioni typy FormsAuthenticationUser. Typy inne niż typ kolekcji mają bezpośredni wpływ na podstawowe tagi konfiguracji.

Ostrzeżenie

Przechowywanie poświadczeń użytkownika w sekcji credentials jest niezabezpieczone. Zamiast tego użyj usługi Azure Key Vault.

Nuta

FormsAuthenticationConfiguration może zapisywać informacje w powiązanej sekcji pliku konfiguracji zgodnie z ograniczeniami zdefiniowanymi przez właściwość sekcji AllowDefinition, których wartość jest MachineToApplication. Każda próba zapisania w pliku konfiguracji na poziomie niedozwolonym w hierarchii spowoduje wyświetlenie komunikatu o błędzie wygenerowanego przez analizator. Można jednak użyć tej klasy do odczytywania informacji o konfiguracji na dowolnym poziomie w hierarchii. W celu zapewnienia bezpieczeństwa i skalowalności zaleca się przechowywanie poświadczeń użytkownika przy użyciu usługi Azure Key Vault.

Konstruktorów

Nazwa	Opis
FormsAuthenticationConfiguration()	Inicjuje nowe wystąpienie klasy FormsAuthenticationConfiguration.

Właściwości

Nazwa	Opis
Cookieless	Pobiera lub ustawia wartość wskazującą, czy uwierzytelnianie oparte na formularzach powinno używać plików cookie.
CookieSameSite	Pobiera lub ustawia wartość atrybutu SameSite pliku cookie.
Credentials	Pobiera kolekcję FormsAuthenticationCredentials nazw użytkowników i haseł.
CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Dziedziczone od ConfigurationElement)
DefaultUrl	Pobiera lub ustawia domyślny adres URL.
Domain	Pobiera lub ustawia nazwę domeny do wysłania przy użyciu plików cookie uwierzytelniania formularzy.
ElementInformation	Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Dziedziczone od ConfigurationElement)
ElementProperty	Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Dziedziczone od ConfigurationElement)
EnableCrossAppRedirects	Pobiera lub ustawia wartość wskazującą, czy uwierzytelnieni użytkownicy mogą być przekierowywani do adresów URL w innych aplikacjach.
EvaluationContext	Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Dziedziczone od ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest null. (Dziedziczone od ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Dziedziczone od ConfigurationElement)
LoginUrl	Pobiera lub ustawia adres URL przekierowania dla żądania.
Name	Pobiera lub ustawia nazwę pliku cookie.
Path	Pobiera lub ustawia ścieżkę pliku cookie.
Properties	Pobiera kolekcję właściwości. (Dziedziczone od ConfigurationElement)
Protection	Pobiera lub ustawia typ szyfrowania używany do szyfrowania pliku cookie.
RequireSSL	Pobiera lub ustawia wartość wskazującą, czy podczas przesyłania informacji uwierzytelniania wymagane jest połączenie ssl (Secure Sockets Layer).
SlidingExpiration	Pobiera lub ustawia przesuwane wygaśnięcie uwierzytelniania.
TicketCompatibilityMode	Pobiera lub ustawia wartość wskazującą, czy używać uniwersalnego czasu koordynowanego (UTC) lub czasu lokalnego dla daty wygaśnięcia biletu.
Timeout	Pobiera lub ustawia limit czasu uwierzytelniania.

Metody

Nazwa	Opis
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationElement)
Equals(Object)	Porównuje bieżące wystąpienie ConfigurationElement z określonym obiektem. (Dziedziczone od ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące wystąpienie ConfigurationElement. (Dziedziczone od ConfigurationElement)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Dziedziczone od ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Dziedziczone od ConfigurationElement)
GetType()	Pobiera Type bieżącego wystąpienia. (Dziedziczone od Object)
Init()	Ustawia obiekt ConfigurationElement na stan początkowy. (Dziedziczone od ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Dziedziczone od ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Dziedziczone od ConfigurationElement)
IsReadOnly()	Pobiera wartość wskazującą, czy obiekt ConfigurationElement jest tylko do odczytu. (Dziedziczone od ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Dziedziczone od ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Dziedziczone od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Dziedziczone od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Dziedziczone od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie można odnaleźć wymaganej właściwości. (Dziedziczone od ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Dziedziczone od ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływana przed serializacji. (Dziedziczone od ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan wewnętrzny obiektu ConfigurationElement, w tym blokady i kolekcje właściwości. (Dziedziczone od ConfigurationElement)
ResetModified()	Resetuje wartość metody IsModified(), aby false po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Dziedziczone od ConfigurationElement)
SetReadOnly()	Ustawia właściwość IsReadOnly() dla obiektu ConfigurationElement i wszystkich podelementów. (Dziedziczone od ConfigurationElement)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt ConfigurationElement, aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Dziedziczone od ConfigurationElement)