FormsAuthenticationConfiguration Klasse

Referenz

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konfiguriert eine ASP.NET-Anwendung für die Verwendung des AuthenticationMode-Formularverhaltens.

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 Sie das FormsAuthenticationConfiguration Objekt aus der Konfigurationsdatei einer vorhandenen Webanwendung abrufen. Sie können dieses Objekt verwenden, um auf seine Elemente zuzugreifen. Die Konfigurationsdatei enthält ein Setup ähnlich wie im folgenden.

Hinweis Wenn Sie den credentials Abschnitt verwenden, achten Sie darauf, die unter ASP.NET Authentifizierung erläuterten Richtlinien zu befolgen. Für Skalierbarkeit und bessere Sicherheit wird empfohlen, dass Sie eine externe Datenbank verwenden, um die Anmeldeinformationen der Benutzer zu speichern. Weitere Informationen zum Erstellen sicherer ASP.NET Anwendungen finden Sie unter Sichern Ihrer ASP.NET Anwendung und Erstellen sicherer ASP.NET Anwendungen: Authentifizierung, Autorisierung und sichere Kommunikation.

In diesem Beispiel wird SHA1 verwendet. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.

<authentication mode="Forms">
  <forms name="MyAppCookie" loginUrl="login.aspx"
    defaultUrl="default.aspx"
    protection="Encryption" timeout="5" path="aspnetTest"
    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("/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 Element eines Konfigurationsabschnitts authentication zuzugreifen und zu forms ändern.

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

Hinweis

Die FormsAuthenticationConfiguration Informationen können in den zugehörigen Abschnitt der Konfigurationsdatei gemäß den Einschränkungen schreiben, die durch die Abschnittseigenschaft AllowDefinition definiert werden, deren Wert ist MachineToApplication. 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 empfiehlt es sich, ein externes Repository wie eine Datenbank zu verwenden, um die Anmeldeinformationen der Benutzer beizubehalten.

Konstruktoren

FormsAuthenticationConfiguration()

Initialisiert eine neue Instanz der FormsAuthenticationConfiguration-Klasse.

Eigenschaften

Cookieless	Ruft einen Wert ab, der angibt, ob für die formularbasierte Authentifizierung Cookies verwendet werden müssen, oder legt diesen fest.
CookieSameSite	Ruft den Wert des Attributs „SameSite“ des Cookies ab oder legt ihn fest.
Credentials	Ruft die FormsAuthenticationCredentials-Auflistung von Benutzernamen und Kennwörtern ab.
CurrentConfiguration	Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört. (Geerbt von ConfigurationElement)
DefaultUrl	Ruft die Standard-URL ab oder legt diese fest.
Domain	Ruft den mit Formularauthentifizierungscookies zu sendenden Domänennamen ab oder legt diesen fest.
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	Ruft einen Wert ab, der angibt, ob authentifizierte Benutzer an URLs in anderen Anwendungen umgeleitet werden können, oder legt diesen fest.
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 `null` ist. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Geerbt von ConfigurationElement)
Item[String]	Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest. (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	Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest. (Geerbt von ConfigurationElement)
LoginUrl	Ruft die Umleitungs-URL für die Anforderung ab oder legt diese fest.
Name	Ruft den Namen des Cookies ab oder legt diesen fest.
Path	Ruft den Cookiepfad ab oder legt diesen fest.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Protection	Ruft den Verschlüsselungstyp für das Verschlüsseln des Cookies ab oder legt diesen fest.
RequireSSL	Ruft einen Wert ab, der angibt, ob beim Übertragen der Authentifizierungsinformationen eine SSL-Verbindung (Secure Sockets Layer) erforderlich ist.
SlidingExpiration	Ruft die gleitende Authentifizierungsablaufzeit ab oder legt diese fest.
TicketCompatibilityMode	Ruft einen Wert ab, der angibt, ob UTC (Coordinated Universal Time) oder Ortszeit für das Ticketablaufdatum verwendet werden soll, oder legt diesen Wert fest.
Timeout	Ruft das Authentifizierungstimeout 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 den Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt für das ConfigurationElement-Objekt den Ausgangszustand 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 geändert wurde, seit es zuletzt gespeichert oder geladen wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element aufgetreten ist. (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 Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified()-Methode auf `false` zurück. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (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)

Gilt für