ApplicationData Class

Proporciona acceso al almacén de datos de la aplicación. Los datos de la aplicación constan de archivos y configuraciones que son locales, móviles o temporales.

Sintaxis


var applicationData = Windows.Storage.ApplicationData;

Atributos

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(MTA)]
[Version(0x06020000)]

Miembros

ApplicationDataClase tiene estos tipos de miembros:

Eventos

ApplicationDataClase tiene estos eventos.

EventoDescripción
DataChanged Occurs when roaming application data is synchronized.

 

Métodos

The ApplicationData Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
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.

 

Propiedades

ApplicationDataClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Current

Solo lecturaProvides access to the app data store associated with the app's app package.

LocalFolder

Solo lecturaGets the root folder in the local app data store.

LocalSettings

Solo lecturaGets the application settings container in the local app data store.

RoamingFolder

Solo lecturaGets the root folder in the roaming app data store.

RoamingSettings

Solo lecturaGets the application settings container in the roaming app data store.

RoamingStorageQuota

Solo lecturaGets the maximum size of the data that can be synchronized to the cloud from the roaming app data store.

TemporaryFolder

Solo lecturaGets the root folder in the temporary app data store.

Version

Solo lecturaGets the version number of the application data in the app data store.

 

Observaciones

ApplicationData proporciona un almacenamiento local, temporal y de movilidad para los datos de la aplicación para cada usuario. Use esta clase para conservar datos específicos de la aplicación entre sesiones y para varios dispositivos.

ApplicationData no proporciona acceso a los archivos de un paquete de la aplicación. Para ello, use Windows.ApplicationModel.Package.InstalledLocation.

ApplicationData.Current ofrece la instancia de ApplicationData de la aplicación. Use esta instancia para obtener el almacén de datos de la aplicación mediante una de estas propiedades:

Hay tres tipos principales de datos de la aplicación:

  • Local: almacenado en el dispositivo y persiste en las actualizaciones.
  • Movilidad: copiado a otros dispositivos donde el usuario ha instalado la aplicación.
  • Temporal: se puede eliminar por el sistema en cualquier momento.

Hay dos tipos principales de almacenamiento de datos de la aplicación:

  • Valores: almacena datos de la aplicación como pares de clave/valor que puede organizar en conjuntos anidados. Estos datos se guardan en el Registro de Windows.
  • Carpetas: almacena datos de la aplicación como archivos en el sistema de archivos.

Puede almacenar los datos de la aplicación en formatos específicos con versiones. Para obtener más información, vea Version e SetVersionAsync.

Para obtener más detalles sobre cómo utilizar estas API, vea Acceso a los datos de la aplicación con Windows en tiempo de ejecución.

Ejemplos

El ejemplo de código siguiente muestra cómo obtener el contenedor de configuración regional para la aplicación.


var applicationData = Windows.Storage.ApplicationData.current;
var localSettings = applicationData.localSettings;

Requisitos

Cliente mínimo compatible

Windows 8 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Servidor mínimo compatible

Windows Server 2012 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Teléfono mínimo compatible

Windows Phone 8

Espacio de nombres

Windows.Storage
Windows::Storage [C++]

Metadatos

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Consulta también

Tareas
Inicio rápido: datos de aplicación locales (JavaScript)
Inicio rápido: datos de aplicación locales (C#/VB/C++)
Inicio rápido: datos de aplicación de movilidad (JavaScript)
Inicio rápido: datos de aplicación de movilidad (C#/VB/C++)
Inicio rápido: datos temporales de la aplicación (JavaScript)
Inicio rápido: datos temporales de la aplicación (C#/VB/C++)
Conceptos
Información general sobre los datos de la aplicación
Instrucciones
Instrucciones para la movilidad de los datos de la aplicación
Instrucciones para la configuración de la aplicación
Referencia
ApplicationDataCompositeValue
ApplicationDataContainer
ApplicationDataContainerSettings
Ejemplos
Ejemplo de configuración de la aplicación
Ejemplo de datos de la aplicación

 

 

Mostrar:
© 2014 Microsoft