<sessionState>, élément

Article
04/11/2008

Configure des paramètres d'état de session pour l'application en cours.

<configuration>
<system.web>
<sessionState>

<sessionStatemode="Off|InProc|StateServer|SQLServer"              cookieless="true|false"              timeout="number of minutes"              stateConnectionString="tcpip=server:port"              sqlConnectionString="sql connection string"              stateNetworkTimeout="number of seconds"/>

Attributs requis

Attribut	Option	Description
mode		Spécifie l'emplacement de stockage de l'état de session.
	Off	Indique que l'état de session n'est pas activé.
	InProc	Indique que l'état de session est stocké en local.
	StateServer	Indique que l'état de session est stocké sur un serveur distant.
	SQLServer	Indique que l'état de session est stocké sur le serveur SQL Server.

Attributs facultatifs

Attribut	Option	Description
cookieless		Spécifie si des sessions dépourvues de cookies doivent être utilisées pour identifier les sessions clientes.
	true	Indique que des sessions dépourvues de cookies doivent être utilisées.
	false	Indique que les sessions dépourvues de cookies ne doivent pas être utilisées. La valeur par défaut est false.
timeout		Spécifie la durée, exprimée en minutes, pendant laquelle une session peut rester inactive avant d'être abandonnée. La valeur par défaut est 20.
stateConnectionString		Spécifie le nom et le port du serveur sur lequel l'état de session est stocké à distance. Par exemple, "tcpip=127.0.0.1:42424". Cet attribut est requis lorsque mode a la valeur StateServer.
sqlConnectionString		Spécifie la chaîne de connexion d'un serveur SQL Server. Par exemple, "data source=localhost;Integrated Security=SSPI;Initial Catalog=northwind". Cet attribut est requis lorsque mode a la valeur SQLServer.
stateNetworkTimeout		Lors de l'utilisation du mode StateServer pour stocker l'état de session, spécifie le nombre de secondes possible pour la durée d'inactivité de la connexion réseau TCP/IP entre le serveur Web et le serveur d'état avant l'abandon de la session. La valeur par défaut est 10.

Notes

Pour utiliser le mode StateServer

Assurez-vous que le service d'état ASP.NET fonctionne sur le serveur distant qui stockera les informations d'état de session. Ce service est installé avec ASP.NET et se trouve par défaut à l'emplacement <Lecteur>:\systemroot\Microsoft.NET\Framework\version\aspnet_state.exe.
Dans le fichier Web.config de l'application, définissez mode=StateServer et définissez l'attribut stateConnectionString. Par exemple, stateConnectionString="tcpip=dataserver:42424".

Pour utiliser le mode SQLServer

Exécutez InstallSqlState.sql (installé par défaut à l'emplacement <Lecteur>:\systemroot\Microsoft.NET\Framework\version) sur l'ordinateur exécutant SQL Server qui stockera l'état de session. Cela crée une base de données appelée ASPState avec les nouvelles procédures stockées et les tables ASPStateTempApplications et ASPStateTempSessions dans la base de données TempDB.
Dans le fichier Web.config de l'application, définissez mode=SQLServer et définissez l'attribut sqlConnectionString. Par exemple, sqlConnectionString="data source=localhost;Integrated Security=SSPI;Initial Catalog=northwind".

Exemple

L'exemple suivant spécifie plusieurs paramètres de configuration d'état de session.

<configuration>
   <system.web>
      <sessionState mode="InProc"
                    cookieless="true"
                    timeout="20"/>
      </sessionState>
   </system.web>
</configuration>

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.SessionState.SessionStateSectionHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET | SessionStateModule

Partager via