ApplicationData class (Windows)

3 out of 10 rated this helpful - Rate this topic

Provides access to the application data store. Application data consists of files and settings that are either local, roaming, or temporary.


public ref class ApplicationData sealed : Object

The ApplicationData class has these types of members:

The ApplicationData class has these events.

Event	Description
DataChanged	Occurs when roaming application data is synchronized.

The ApplicationData class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
ClearAsync()	Removes all application data from the local, roaming, and temporary app data stores.
ClearAsync(ApplicationDataLocality)	Removes all application data from the specified app data store.
SetVersionAsync	Sets the version number of the application data in the app data store.
SignalDataChanged	Sends a DataChanged \| datachanged event to all registered event handlers.

The ApplicationData class has these properties.

Property	Access type	Description
Current	Read-only	Provides access to the app data store associated with the app's app package.
LocalFolder	Read-only	Gets the root folder in the local app data store.
LocalSettings	Read-only	Gets the application settings container in the local app data store.
RoamingFolder	Read-only	Gets the root folder in the roaming app data store.
RoamingSettings	Read-only	Gets the application settings container in the roaming app data store.
RoamingStorageQuota	Read-only	Gets the maximum size of the data that can be synchronized to the cloud from the roaming app data store.
TemporaryFolder	Read-only	Gets the root folder in the temporary app data store.
Version	Read-only	Gets the version number of the application data in the app data store.

An app can also include files in its app package. To access files in the app package, use Windows.ApplicationModel.Package.Current.InstalledLocation.

The following code example demonstrates how to get the local settings container for the app.


using namespace Windows::Storage;

ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

Minimum supported client	Windows 8 [Windows Store apps, desktop apps]
Minimum supported server	Windows Server 2012 [Windows Store apps, desktop apps]
Minimum supported phone	Windows Phone 8
Namespace	Windows.Storage Windows::Storage [C++]
Metadata	Windows.winmd
DLL	Windows.Storage.ApplicationData.dll

ApplicationData class