ApplicationDataContainer Class

Rappresenta un contenitore per le impostazioni dell'app.I metodi e le proprietà di questa classe supportano la creazione, l'eliminazione, l'enumerazione e l'attraversamento della gerarchia del contenitore.

Sintassi


Public NotInheritable Class ApplicationDataContainer

Attributi

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

Membri

Il ApplicationDataContainerClasse dispone di questi tipi di membri:

Metodi

The ApplicationDataContainer Classe dispone di questi metodi. Con C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
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.

 

Proprietà

Il ApplicationDataContainerClasse dispone di queste proprietà.

ProprietàTipo accessoDescrizione

Containers

Sola letturaGets the child application settings containers of this application settings container.

Locality

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

Name

Sola letturaGets the name of the current settings container.

Values

Sola letturaGets an object that represents the settings in this settings container.

 

Osservazioni

Nota  Non esiste alcun contenitore delle impostazioni dell'archivio dati temporanei dell'applicazione.

La proprietà Values ottiene un oggetto ApplicationDataContainerSettings che fornisce accesso alle impostazioni archiviate nel contenitore.

Windows Phone 8

Questa API non è implementata e genererà un'eccezione se viene chiamata. Vedere API di runtime di Windows Phone.

Esempi

Chiamare il metodo ApplicationDataContainer.CreateContainer | createContainer per creare un contenitore di impostazioni. In questo esempio viene creato un contenitore delle impostazioni denominato exampleContainer e viene aggiunta un'impostazione denominata exampleSetting. Il valore Always | always dell'enumerazione ApplicationDataCreateDisposition indica che il contenitore deve essere creato se non esiste già.

Utilizzare la proprietà ApplicationDataContainer.Values | values per accedere all'impostazione exampleSetting nel contenitore exampleContainer.

Chiamare il metodo ApplicationDataContainer.DeleteContainer | deleteContainer per eliminare il contenitore di impostazioni exampleContainer quando non è più necessario.


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")

Requisiti

Client minimo supportato

Windows 8 [app di Windows Store, app desktop]

Server minimo supportato

Windows Server 2012 [app di Windows Store, app desktop]

Telefono minimo supportato

Windows Phone 8 [non implementato, vedi Osservazioni]

Spazio dei nomi

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

Metadati

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Vedi anche

Attività
Guida introduttiva: Dati dell'applicazione locale (JavaScript)
Guida introduttiva: Dati dell'applicazione locale (C#/VB/C++)
Guida introduttiva: Dati dell'applicazione di roaming (JavaScript)
Guida introduttiva sui dati dell'applicazione di roaming (C#/VB/C++)
Concetti
Panoramica dei dati dell'applicazione
Riferimento
ApplicationData
ApplicationDataCompositeValue
ApplicationDataContainerSettings
Esempi
Esempio di dati dell'applicazione.

 

 

Mostra:
© 2014 Microsoft