SessionStateSection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Configura lo stato sessione per un'applicazione Web.
public ref class SessionStateSection sealed : System::Configuration::ConfigurationSectionpublic sealed class SessionStateSection : System.Configuration.ConfigurationSectiontype SessionStateSection = class
inherit ConfigurationSectionPublic NotInheritable Class SessionStateSection
Inherits ConfigurationSection- Ereditarietà
Esempio
Questa sezione fornisce due esempi di codice. La prima illustra come specificare i valori dichiarativi per diversi attributi della sessionState sezione, a cui è anche possibile accedere come membri della SessionStateSection classe. Il secondo illustra come usare la SessionStateSection classe.
Nell'esempio di file di configurazione seguente viene illustrato come specificare i valori dichiarativi per la sessionState sezione.
<configuration>
<system.web>
<sessionState mode="InProc"
stateConnectionString="tcpip=127.0.0.1:42424"
stateNetworkTimeout="10"
sqlConnectionString="data source=127.0.0.1;
Integrated Security=SSPI"
sqlCommandTimeout="30"
customProvider=""
cookieless="UseDeviceProfile"
cookieName="ASP.NET_SessionId"
timeout="20"
allowCustomSqlDatabase="False"
regenerateExpiredSessionId="False"
partitionResolverType=""
useHostingIdentity="True">
<providers>
<clear />
</providers>
</sessionState>
</system.web>
</configuration>
Nell'esempio di codice seguente viene illustrato come usare la SessionStateSection classe.
// Get the Web application configuration object.
System.Configuration.Configuration configuration =
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the section related object.
System.Web.Configuration.SessionStateSection sessionStateSection =
(System.Web.Configuration.SessionStateSection)
configuration.GetSection("system.web/sessionState");
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest")
' Get the section.
Dim sessionStateSection As System.Web.Configuration.SessionStateSection = _
CType(configuration.GetSection("system.web/sessionState"), _
System.Web.Configuration.SessionStateSection)
Commenti
La SessionStateSection classe fa riferimento all'elemento nel file di configurazione Machine.config o Web.config identificato dal sessionState tag.
Quando un nuovo client inizia a interagire con un'applicazione Web, viene emesso un ID sessione e associato a tutte le richieste successive dello stesso client durante il periodo di validità della sessione. Questo ID viene usato per mantenere lo stato lato server associato alla sessione client tra le richieste. Controlla SessionStateSection il modo in cui l'applicazione ASP.NET stabilisce e gestisce questa associazione per conto di ogni client.
Questo meccanismo è molto flessibile e offre la possibilità di ospitare informazioni sullo stato della sessione fuori processo e di tenere traccia dello stato senza usare i cookie, tra le altre cose.
Costruttori
| SessionStateSection() |
Inizializza una nuova istanza della classe SessionStateSection. |
Proprietà
| AllowCustomSqlDatabase |
Ottiene o imposta un valore che indica se l'utente può specificare il valore iniziale del catalogo nella proprietà SqlConnectionString. |
| CompressionEnabled |
Ottiene o imposta un valore che indica se la compressione è abilitata per i dati dello stato sessione. |
| Cookieless |
Ottiene o imposta un valore che indica se i cookie vengono utilizzati per identificare le sessioni client. |
| CookieName |
Ottiene o imposta il nome del cookie. |
| CookieSameSite |
Ottiene o imposta il valore dell'attributo SameSite del cookie. |
| CurrentConfiguration |
Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement) |
| CustomProvider |
Ottiene o imposta il nome del provider personalizzato dall'insieme Providers. |
| ElementInformation |
Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| ElementProperty |
Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement) |
| EvaluationContext |
Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| HasContext |
Ottiene un valore che indica se la proprietà CurrentConfiguration è |
| 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 l'insieme di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockAllElementsExcept |
Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockAttributes |
Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockElements |
Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockItem |
Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement) |
| Mode |
Ottiene o imposta un valore che specifica dove deve essere archiviato lo stato sessione. |
| PartitionResolverType |
Ottiene o imposta un valore che specifica dove deve essere archiviato lo stato sessione. |
| Properties |
Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement) |
| Providers |
Ottiene i provider ProviderSettingsCollection correnti. |
| RegenerateExpiredSessionId |
Ottiene o imposta un valore che indica se l'ID di sessione verrà emesso nuovamente quando un ID di sessione scaduto viene specificato dal client. |
| SectionInformation |
Ottiene un oggetto SectionInformation contenente le informazioni non personalizzabili e la funzionalità dell'oggetto ConfigurationSection. (Ereditato da ConfigurationSection) |
| SessionIDManagerType |
Ottiene o imposta un valore che specifica il tipo completo del programma di gestione dell'ID di sessione. |
| SqlCommandTimeout |
Ottiene o imposta la durata del timeout per i comandi SQL che utilizzano la modalità dello stato sessione SQL Server. |
| SqlConnectionRetryInterval |
Ottiene o imposta l'intervallo di tempo che deve trascorrere prima che ASP.NET si riconnetta al database. |
| SqlConnectionString |
Ottiene o imposta la stringa di connessione SQL. |
| StateConnectionString |
Ottiene o imposta la stringa di connessione del server di stato. |
| StateNetworkTimeout |
Ottiene o imposta la quantità di tempo durante cui la connessione di rete tra il server Web e il server di stato può rimanere inattiva. |
| Timeout |
Ottiene o imposta il timeout della sessione. |
| UseHostingIdentity |
Ottiene o imposta un valore che specifica se lo stato sessione utilizzerà la rappresentazione del client, se disponibile, o se ripristinerà sempre l'identità di hosting. |
Metodi
| DeserializeElement(XmlReader, Boolean) |
Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement) |
| DeserializeSection(XmlReader) |
Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationSection) |
| Equals(Object) |
Confronta l'istanza corrente di ConfigurationElement con l'oggetto specificato. (Ereditato da ConfigurationElement) |
| GetHashCode() |
Ottiene un valore univoco che rappresenta l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement) |
| GetRuntimeObject() |
Restituisce un oggetto personalizzato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement) |
| GetTransformedTypeString(String) |
Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| Init() |
Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| InitializeDefault() |
Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| IsModified() |
Indica se questo elemento di configurazione è stato modificato dall'ultimo salvataggio o caricamento durante l'implementazione in una classe derivata. (Ereditato da ConfigurationSection) |
| IsReadOnly() |
Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement) |
| ListErrors(IList) |
Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement) |
| PostDeserialize() |
Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement) |
| PreSerialize(XmlWriter) |
Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement) |
| Reset(ConfigurationElement) |
Reimposta lo stato interno dell'oggetto ConfigurationElement, inclusi i blocchi e le raccolte di proprietà. (Ereditato da ConfigurationElement) |
| ResetModified() |
Reimposta il valore del metodo IsModified() su |
| SerializeElement(XmlWriter, Boolean) |
Scrive il contenuto di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Crea una stringa XML contenente una visualizzazione non unita dell'oggetto ConfigurationSection come sezione singola da scrivere in un file. (Ereditato da ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione 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) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica se l'elemento specificato deve essere serializzato quando la gerarchia degli oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica se la proprietà specificata deve essere serializzata quando la gerarchia degli oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica se l'istanza corrente ConfigurationSection deve essere serializzata quando la gerarchia di oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica l'oggetto ConfigurationElement in modo da rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement) |
