This documentation is archived and is not being maintained.

SessionStateStoreProviderBase::CreateNewStoreData Method

Creates a new SessionStateStoreData object to be used for the current request.

Namespace:  System.Web.SessionState
Assembly:  System.Web (in System.Web.dll)

virtual SessionStateStoreData^ CreateNewStoreData(
	HttpContext^ context, 
	int timeout
) abstract


Type: System.Web::HttpContext
The HttpContext for the current request.
Type: System::Int32
The session-state Timeout value for the new SessionStateStoreData.

Return Value

Type: System.Web.SessionState::SessionStateStoreData
A new SessionStateStoreData for the current request.

The SessionStateModule object calls the CreateNewStoreData method at the beginning of a request for an ASP.NET page, during the AcquireRequestState event. The CreateNewStoreData method is called if:

  • the incoming request has no session ID, or

  • the incoming request has a session ID, but the session is not found in the data store.

The CreateNewStoreData method creates a new SessionStateStoreData object with an empty ISessionStateItemCollection object, an HttpStaticObjectsCollection collection, and the specified timeout value. The HttpStaticObjectsCollection collection for the ASP.NET application can be retrieved using the GetSessionStaticObjects method.

For an example of a session-state store provider implementation, see Implementing a Session-State Store Provider.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.