SessionStateStoreProviderBase.GetItemExclusive Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns read-only session-state data from the session data store.
public:
abstract System::Web::SessionState::SessionStateStoreData ^ GetItemExclusive(System::Web::HttpContext ^ context, System::String ^ id, [Runtime::InteropServices::Out] bool % locked, [Runtime::InteropServices::Out] TimeSpan % lockAge, [Runtime::InteropServices::Out] System::Object ^ % lockId, [Runtime::InteropServices::Out] System::Web::SessionState::SessionStateActions % actions);public abstract System.Web.SessionState.SessionStateStoreData GetItemExclusive (System.Web.HttpContext context, string id, out bool locked, out TimeSpan lockAge, out object lockId, out System.Web.SessionState.SessionStateActions actions);abstract member GetItemExclusive : System.Web.HttpContext * string * bool * TimeSpan * obj * SessionStateActions -> System.Web.SessionState.SessionStateStoreDataPublic MustOverride Function GetItemExclusive (context As HttpContext, id As String, ByRef locked As Boolean, ByRef lockAge As TimeSpan, ByRef lockId As Object, ByRef actions As SessionStateActions) As SessionStateStoreDataParameters
- context
- HttpContext
The HttpContext for the current request.
- locked
- Boolean
When this method returns, contains a Boolean value that is set to true if a lock is successfully obtained; otherwise, false.
- lockAge
- TimeSpan
When this method returns, contains a TimeSpan object that is set to the amount of time that an item in the session data store has been locked.
- lockId
- Object
When this method returns, contains an object that is set to the lock identifier for the current request. For details on the lock identifier, see "Locking Session-Store Data" in the SessionStateStoreProviderBase class summary.
- actions
- SessionStateActions
When this method returns, contains one of the SessionStateActions values, indicating whether the current session is an uninitialized, cookieless session.
Returns
A SessionStateStoreData populated with session values and information from the session data store.
Examples
For an example of a session-state store provider implementation, see Implementing a Session-State Store Provider.
Remarks
The SessionStateModule object calls the GetItemExclusive method at the beginning of a request, during the AcquireRequestState event, when the EnableSessionState attribute is set to true, which is the default. If the EnableSessionState attribute is set to ReadOnly, the SessionStateModule object instead calls the GetItem method.
The GetItemExclusive method returns a SessionStateStoreData object populated with session information from the data store, updates the expiration date of the stored data, and locks the session-item data at the data store for the duration of the request. If no session-item data is found at the data store, the GetItemExclusive method sets the locked out parameter to false and returns null. This causes the SessionStateModule object to call the CreateNewStoreData method to create a new session item in the data store. If session-item data is found at the data store but the data is locked, the GetItemExclusive method sets the locked out parameter to true, sets the lockAge out parameter to the current date and time minus the date and time when the item was locked (which is retrieved from the data store), sets the lockId out parameter to the lock identifier retrieved from the data store, and returns null. This causes the SessionStateModule object to call the GetItemExclusive method again after a half-second interval to attempt to retrieve the session-item information and obtain a lock on the data. If the value that the lockAge out parameter is set to exceeds the ExecutionTimeout value, then the SessionStateModule calls the ReleaseItemExclusive method to clear the lock on the session-item data, and then calls the GetItemExclusive method again.
The actionFlags parameter is used when the cookieless and regenerateExpiredSessionId attributes are both set to true. An actionFlags value set to InitializeItem indicates that the entry in the session data store is a new session that requires initialization. Uninitialized entries in the session data store are created by a call to the CreateUninitializedItem method. If the item from the session data store is not an uninitialized item, the actionFlags parameter will be set to zero.
Custom session-state store implementers that support cookieless sessions should set the actionFlags out parameter to the value returned from the session data store for the current item. If the actionFlags parameter value for the requested session-store item equals the InitializeItem enumeration value, then the GetItemExclusive method should set the value in the data store to zero after setting the actionFlags out parameter.
