FormsAuthenticationConfiguration Classe

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Configura un'applicazione ASP.NET per l'uso della modalità AuthenticationMode form.

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

Ereditarietà

Object

ConfigurationElement

FormsAuthenticationConfiguration

Esempio

Nell'esempio di codice seguente viene illustrato come ottenere l'oggetto FormsAuthenticationConfiguration dal file di configurazione di un'applicazione Web esistente. È possibile utilizzare questo oggetto per accedere ai relativi membri.

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

Commenti

La classe FormsAuthenticationConfiguration consente di accedere e modificare a livello di codice l'elemento forms di una sezione di authentication di configurazione.

Questo tipo fa parte di un gruppo che include il FormsAuthenticationCredentials, il FormsAuthenticationUserCollectione i tipi di FormsAuthenticationUser. I tipi diversi dal tipo di raccolta influiscono direttamente sui tag di configurazione sottostanti.

Avvertimento

L'archiviazione delle credenziali utente nella sezione credentials è non sicura. Usare invece Azure Key Vault.

Nota

Il FormsAuthenticationConfiguration può scrivere informazioni nella sezione correlata del file di configurazione in base alle restrizioni definite dalla proprietà della sezione AllowDefinition il cui valore è MachineToApplication. Qualsiasi tentativo di scrittura in un file di configurazione a un livello non consentito nella gerarchia genererà un messaggio di errore generato dal parser. Tuttavia, è possibile usare questa classe per leggere le informazioni di configurazione a qualsiasi livello della gerarchia. Per garantire sicurezza e scalabilità, è consigliabile usare azure Key Vault per archiviare le credenziali utente.

Costruttori

FormsAuthenticationConfiguration()

Inizializza una nuova istanza della classe FormsAuthenticationConfiguration.

Proprietà

Cookieless	Ottiene o imposta un valore che indica se l'autenticazione basata su form deve utilizzare i cookie.
CookieSameSite	Ottiene o imposta il valore per l'attributo SameSite del cookie.
Credentials	Ottiene la raccolta di FormsAuthenticationCredentials di nomi utente e password.
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement)
DefaultUrl	Ottiene o imposta l'URL predefinito.
Domain	Ottiene o imposta il nome di dominio da inviare con i cookie di autenticazione basata su form.
ElementInformation	Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EnableCrossAppRedirects	Ottiene o imposta un valore che indica se gli utenti autenticati possono essere reindirizzati agli URL in altre applicazioni.
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è null. (Ereditato da ConfigurationElement)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene o imposta una proprietà, un attributo o un elemento figlio di questo elemento di configurazione. (Ereditato da ConfigurationElement)
LockAllAttributesExcept	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
LoginUrl	Ottiene o imposta l'URL di reindirizzamento per la richiesta.
Name	Ottiene o imposta il nome del cookie.
Path	Ottiene o imposta il percorso del cookie.
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
Protection	Ottiene o imposta il tipo di crittografia utilizzato per crittografare il cookie.
RequireSSL	Ottiene o imposta un valore che indica se è necessaria una connessione SSL (Secure Sockets Layer) durante la trasmissione delle informazioni di autenticazione.
SlidingExpiration	Ottiene o imposta la scadenza scorrevole dell'autenticazione.
TicketCompatibilityMode	Ottiene o imposta un valore che indica se utilizzare l'ora UTC (Coordinated Universal Time) o l'ora locale per la data di scadenza del ticket.
Timeout	Ottiene o imposta il timeout di autenticazione.

Metodi

DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta l'istanza di ConfigurationElement corrente con l'oggetto specificato. (Ereditato da ConfigurationElement)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome dell'assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Init()	Imposta l'oggetto ConfigurationElement sullo stato iniziale. (Ereditato da ConfigurationElement)
InitializeDefault()	Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsModified()	Indica se questo elemento di configurazione è stato modificato dopo l'ultimo salvataggio o caricamento, se implementato in una classe derivata. (Ereditato da ConfigurationElement)
IsReadOnly()	Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement)
ListErrors(IList)	Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ottiene un valore che indica se durante la deserializzazione viene rilevato un elemento sconosciuto. (Ereditato da ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement)
PostDeserialize()	Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Chiamato prima della serializzazione. (Ereditato da ConfigurationElement)
Reset(ConfigurationElement)	Reimposta lo stato interno dell'oggetto ConfigurationElement, inclusi i blocchi e gli insiemi di proprietà. (Ereditato da ConfigurationElement)
ResetModified()	Reimposta il valore del metodo IsModified() su false quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Scrive il contenuto di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElement e tutti i sottoelementi. (Ereditato da ConfigurationElement)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica l'oggetto ConfigurationElement per rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement)