ApplicationDataContainer Class

Representa un contenedor de valores de configuración de la aplicación. Representa un contenedor de valores de configuración de la aplicación. Los métodos y propiedades de esta clase permiten crear, eliminar, enumerar y recorrer la jerarquía del contenedor.

Sintaxis


Public NotInheritable Class ApplicationDataContainer

Atributos

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

Miembros

ApplicationDataContainerClase tiene estos tipos de miembros:

Métodos

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

MétodoDescripción
CreateContainer Creates or opens the specified settings container in the current settings container.
DeleteContainer Deletes the specified settings container, its subcontainers, and all application settings in the hierarchy.

 

Propiedades

ApplicationDataContainerClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Containers

Solo lecturaGets the child application settings containers of this application settings container.

Locality

Solo lecturaGets the type (local or roaming) of the app data store that is associated with the current settings container.

Name

Solo lecturaGets the name of the current settings container.

Values

Solo lecturaGets an object that represents the settings in this settings container.

 

Observaciones

Nota  No hay ningún contenedor de valores para el almacén de datos temporal de la aplicación.

La propiedad Values obtiene un objeto ApplicationDataContainerSettings que proporciona acceso a los valores almacenados en el contenedor.

Windows Phone 8

Esta API no se implementa y producirá una excepción si se llama. Vea API Runtime de Windows Phone.

Ejemplos

Llame al método ApplicationDataContainer.CreateContainer | createContainer para crear un contenedor de configuración. Este ejemplo crea un contenedor de configuración denominado exampleContainer y agrega un valor denominado exampleSetting. El valor Always | always de la enumeración ApplicationDataCreateDisposition indica que el contenedor se debe crear si no existe.

Utilice la propiedad ApplicationDataContainer.Values | values para tener acceso al valor exampleSetting del contenedor exampleContainer.

Llame al método ApplicationDataContainer.DeleteContainer | deleteContainer para eliminar el contenedor de configuración exampleContainer cuando termine con él.


Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings

' Create a setting in a container

Dim container As Windows.Storage.ApplicationDataContainer = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always)

If localSettings.Containers.ContainsKey("exampleContainer") Then
    localSettings.Containers("exampleContainer").Values("exampleSetting") = "Hello Windows"
End If

' Read data from a setting in a container

Dim hasContainer As Boolean = localSettings.Containers.ContainsKey("exampleContainer")
Dim hasSetting As Boolean = False

If hasContainer Then
    hasSetting = localSettings.Containers("exampleContainer").Values.ContainsKey("exampleSetting")
End If

' Delete a container

localSettings.DeleteContainer("exampleContainer")

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 [no está implementado, consulta Observaciones]

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++)
Conceptos
Información general sobre los datos de la aplicación
Referencia
ApplicationData
ApplicationDataCompositeValue
ApplicationDataContainerSettings
Ejemplos
Ejemplo de datos de la aplicación

 

 

Mostrar:
© 2014 Microsoft