Sets the version number of the application data in the app data store.
Syntax
applicationData.setVersionAsync(desiredVersion, handler).done( /* Your success and error handlers */ );
Parameters
- desiredVersion
-
Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]
The new version number.
- handler
-
Type: ApplicationDataSetVersionHandler
The set version event handler.
Return value
Type: IAsyncAction
An object that is used to manage the asynchronous set version operation.
Remarks
Versioning enables you to change the application data format used in a future release of your app without causing compatibility problems with previous releases of your app. The app checks the version of the data in the data store, and if it is less than the version the app expects, the app should update the application data to the new format and update the version.
It is strongly recommended that you use sequential and incrementing version numbers, starting at 1.
Windows Phone 8
This API is not implemented and will throw an exception if called.
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Minimum supported phone | Windows Phone 8 |
|
Namespace |
|
|
Metadata |
|
See also
Build date: 2/25/2013
