WebSession.SaveState

Method

WebSession.SaveState(Name as String, Data As String = "", Replace As Boolean = False)

Supported for all project types and targets.

Saves the Name/Data pair to a per-session stack so you can restore the page when the user returns via their browser's Back button.

Notes

When the user navigates between pages, the HashTagChanged event will then fire and pass back to you the Name/Data pair you previously saved from the top of the stack. The Name is automatically used as the page's hashtag. The data is whatever you need to restore the contents of the page. It can be in any form that String supports.

You can call SaveState at any time while a page is present. Passing True for the Replace parameter, replaces the Name/Data pair saved the last time SaveState was called with the new Name/Data pair.

Data is only removed from this stack when you save a new state in the middle of the stack. For instance, if you were to save the state five times, press BACK twice and save again, it would remove the old fourth and fifth items and add the new one to the end.

The stack is stored client-side with the browser.

See Also

WebSession.HashTagChanged event.