State Property
Collapse the table of content
Expand the table of content

PhoneApplicationService.State Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets the dictionary used for passing an application’s state between invocations.

Namespace:  Microsoft.Phone.Shell
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)

public IDictionary<string, Object> State { get; }

ExceptionCondition
InvalidOperationException

The State dictionary cannot be modified after the Deactivated event has been handled or before the Activated event has been raised.

ArgumentOutOfRangeException

Values placed in the State dictionary must be serializable. This exception is only thrown while debugging. At run time, this exception is silently ignored.

Windows Phone applications are deactivated when the user navigates to another application. When the user returns to the application, by using the Back button or by completing a Launcher or Chooser task, the application is reactivated. An application can store transient application state in the State dictionary in the handler for the Deactivated event. In the Activated event handler, an application can use the values stored in the State dictionary to transient application state.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2016 Microsoft