SessionStateSection Classe

Définition

Espace de noms:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Configure l’état de session d’une application 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

Héritage: Object

ConfigurationElement

ConfigurationSection
SessionStateSection

Exemples

Cette section fournit deux exemples de code. La première montre comment spécifier des valeurs de manière déclarative pour plusieurs attributs de la sessionState section, qui sont également accessibles en tant que membres de la SessionStateSection classe. La deuxième montre comment utiliser la SessionStateSection classe.

L’exemple de fichier de configuration suivant montre comment spécifier des valeurs de manière déclarative pour la sessionState section.

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

L’exemple de code suivant montre comment utiliser 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)

Remarques

La SessionStateSection classe fait référence à l’élément dans le fichier de configuration Machine.config ou Web.config identifié par la sessionState balise.

Lorsqu’un nouveau client commence à interagir avec une application web, un ID de session est émis et associé à toutes les demandes suivantes du même client pendant la durée de validité de la session. Cet ID est utilisé pour maintenir l’état côté serveur associé à la session cliente entre les requêtes. Le SessionStateSection contrôle la façon dont l’application ASP.NET établit et gère cette association au nom de chaque client.

Ce mécanisme est très flexible et vous permet d’héberger des informations d’état de session hors processus et de suivre l’état sans utiliser de cookies, entre autres.

Constructeurs

Nom	Description
SessionStateSection()	Initialise une nouvelle instance de la classe SessionStateSection.

Propriétés

Nom	Description
AllowCustomSqlDatabase	Obtient ou définit une valeur indiquant si l’utilisateur peut spécifier la valeur de catalogue initiale dans la SqlConnectionString propriété.
CompressionEnabled	Obtient ou définit une valeur qui indique si la compression est activée pour les données d’état de session.
Cookieless	Obtient ou définit une valeur indiquant si les cookies sont utilisés pour identifier les sessions clientes.
CookieName	Obtient ou définit le nom du cookie.
CookieSameSite	Obtient ou définit la valeur de l’attribut SameSite du cookie.
CurrentConfiguration	Obtient une référence à l’instance de niveau supérieur Configuration qui représente la hiérarchie de configuration à laquelle appartient l’instance ConfigurationElement actuelle. (Hérité de ConfigurationElement)
CustomProvider	Obtient ou définit le nom du fournisseur personnalisé de la Providers collection.
ElementInformation	Obtient un objet ElementInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la propriété CurrentConfiguration est `null`. (Hérité de ConfigurationElement)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
LockAllAttributesExcept	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement)
Mode	Obtient ou définit une valeur spécifiant où stocker l’état de session.
PartitionResolverType	Obtient ou définit une valeur spécifiant où stocker l’état de session.
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)
Providers	Obtient les fournisseurs actuels ProviderSettingsCollection .
RegenerateExpiredSessionId	Obtient ou définit une valeur indiquant si l’ID de session sera réinscrit lorsqu’un ID de session expiré est spécifié par le client.
SectionInformation	Obtient un SectionInformation objet qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationSection . (Hérité de ConfigurationSection)
SessionIDManagerType	Obtient ou définit une valeur spécifiant le type qualifié complet du Gestionnaire d’ID de session.
SqlCommandTimeout	Obtient ou définit le délai d’expiration pour les commandes SQL à l’aide du mode d’état de session SQL Server.
SqlConnectionRetryInterval	Obtient ou définit l’intervalle de temps qui doit s’écouler avant ASP.NET se reconnecte à la base de données.
SqlConnectionString	Obtient ou définit la chaîne de connexion SQL.
StateConnectionString	Obtient ou définit la chaîne de connexion du serveur d’état.
StateNetworkTimeout	Obtient ou définit la durée pendant laquelle la connexion réseau entre le serveur Web et le serveur d’état peut rester inactive.
Timeout	Obtient ou définit le délai d’expiration de la session.
UseHostingIdentity	Obtient ou définit une valeur spécifiant si l’état de session utilise l’emprunt d’identité du client lorsqu’il est disponible ou rétablit toujours l’identité d’hébergement.

Méthodes

Nom	Description
DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
DeserializeSection(XmlReader)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationSection)
Equals(Object)	Compare l’instance actuelle ConfigurationElement à l’objet spécifié. (Hérité de ConfigurationElement)
GetHashCode()	Obtient une valeur unique représentant l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement)
GetRuntimeObject()	Retourne un objet personnalisé en cas de substitution dans une classe dérivée. (Hérité de ConfigurationSection)
GetTransformedAssemblyString(String)	Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Init()	Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement)
InitializeDefault()	Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement. (Hérité de ConfigurationElement)
IsModified()	Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargé lors de l’implémentation dans une classe dérivée. (Hérité de ConfigurationSection)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
ListErrors(IList)	Ajoute les erreurs de propriété non valides dans cet objet ConfigurationElement et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Reset(ConfigurationElement)	Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement)
ResetModified()	Réinitialise la valeur de la IsModified() méthode `false` lorsqu’elle est implémentée dans une classe dérivée. (Hérité de ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Crée une chaîne XML contenant une vue non fusionnée de l’objet ConfigurationSection sous la forme d’une section unique à écrire dans un fichier. (Hérité de ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Indique si l’élément spécifié doit être sérialisé lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Indique si la propriété spécifiée doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Indique si l’instance ConfigurationSection actuelle doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du framework .NET. (Hérité de ConfigurationSection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?