FormsAuthenticationConfiguration Klasse

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Konfiguriert eine ASP.NET Anwendung für die Verwendung der AuthenticationMode Formularmodalität.

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

Vererbung

Object

ConfigurationElement

FormsAuthenticationConfiguration

Beispiele

Das folgende Codebeispiel zeigt, wie Das FormsAuthenticationConfiguration-Objekt aus der Konfigurationsdatei einer vorhandenen Webanwendung abgerufen wird. Sie können dieses Objekt verwenden, um auf seine Member zuzugreifen.

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

Hinweise

Die FormsAuthenticationConfiguration-Klasse bietet eine Möglichkeit, programmgesteuert auf das forms-Element eines Konfigurations-authentication Abschnitts zuzugreifen und sie zu ändern.

Dieser Typ ist Teil einer Gruppe, die die FormsAuthenticationCredentials,die FormsAuthenticationUserCollectionund die FormsAuthenticationUser Typen enthält. Die anderen Typen als der Sammlungstyp wirken sich direkt auf die zugrunde liegenden Konfigurationstags aus.

Warnung

Das Speichern von Benutzeranmeldeinformationen im Abschnitt credentials ist unsichere. Verwenden Sie stattdessen Azure Key Vault.

Anmerkung

Die FormsAuthenticationConfiguration können Informationen in den zugehörigen Abschnitt der Konfigurationsdatei entsprechend den durch die Abschnittseigenschaft definierten Einschränkungen AllowDefinition schreiben, deren Wert MachineToApplicationist. Jeder Versuch, in eine Konfigurationsdatei auf einer Ebene zu schreiben, die in der Hierarchie nicht zulässig ist, führt zu einer Fehlermeldung, die vom Parser generiert wird. Sie können diese Klasse jedoch verwenden, um Konfigurationsinformationen auf jeder Ebene in der Hierarchie zu lesen. Für Sicherheit und Skalierbarkeit wird empfohlen, Azure Key Vault- zum Speichern von Benutzeranmeldeinformationen zu verwenden.

Konstruktoren

FormsAuthenticationConfiguration()

Initialisiert eine neue Instanz der FormsAuthenticationConfiguration Klasse.

Eigenschaften

Cookieless	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die formularbasierte Authentifizierung Cookies verwenden soll.
CookieSameSite	Dient zum Abrufen oder Festlegen des Werts für das SameSite-Attribut des Cookies.
Credentials	Ruft die FormsAuthenticationCredentials Auflistung von Benutzernamen und Kennwörtern ab.
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
DefaultUrl	Ruft die Standard-URL ab oder legt sie fest.
Domain	Dient zum Abrufen oder Festlegen des Domänennamens, der mit Formularauthentifizierungscookies gesendet werden soll.
ElementInformation	Ruft ein ElementInformation -Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement -Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EnableCrossAppRedirects	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob authentifizierte Benutzer zu URLS in anderen Anwendungen umgeleitet werden können.
EvaluationContext	Ruft das ContextInformation -Objekt für das ConfigurationElement -Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration -Eigenschaft nullist. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
LoginUrl	Dient zum Abrufen oder Festlegen der Umleitungs-URL für die Anforderung.
Name	Ruft den Cookienamen ab oder legt den Namen fest.
Path	Dient zum Abrufen oder Festlegen des Cookiepfads.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Protection	Ruft den Verschlüsselungstyp ab, der zum Verschlüsseln des Cookies verwendet wird, oder legt diesen fest.
RequireSSL	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob beim Übertragen von Authentifizierungsinformationen eine SSL-Verbindung (Secure Sockets Layer) erforderlich ist.
SlidingExpiration	Dient zum Abrufen oder Festlegen des Ablaufs der Authentifizierung.
TicketCompatibilityMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob koordinierte Weltzeit (Coordinated Universal Time, UTC) oder Ortszeit für das Ablaufdatum des Tickets verwendet werden soll.
Timeout	Ruft das Timeout der Authentifizierung ab oder legt dieses fest.

Methoden

DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die aktuelle ConfigurationElement Instanz mit dem angegebenen Objekt. (Geerbt von ConfigurationElement)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement Instanz darstellt. (Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement-Objekt auf den Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Gibt an, ob dieses Konfigurationselement seit dem letzten Speichern oder Laden geändert wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement -Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement-Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Zustand des ConfigurationElement -Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt den Wert der IsModified()-Methode auf false zurück, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei, wenn es in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly()-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)