SessionStateSection Classe

Definizione

Configura lo stato sessione per un'applicazione Web.

public ref class SessionStateSection sealed : System::Configuration::ConfigurationSection
public sealed class SessionStateSection : System.Configuration.ConfigurationSection
type SessionStateSection = class
    inherit ConfigurationSection
Public 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 è 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 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 false quando viene implementato in una classe derivata.

(Ereditato da ConfigurationSection)
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)

Si applica a

Vedi anche