Language: HTML | XAML

Schnellstart: Lokale App-Daten (XAML)

Applies to Windows and Windows Phone

Hier erfahren Sie, wie Sie Einstellungen und Daten im lokalen App-Datenspeicher speichern und daraus abrufen.

Roadmap: Wie hängt dieses Thema mit anderen zusammen? Informationen finden Sie unter:

Abrufen der Container für die Einstellungen und Dateien der App

Verwenden Sie die ApplicationData.LocalSettings-Eigenschaft, um die Einstellungen aus einem ApplicationDataContainer-Objekt abzurufen. Verwenden Sie die ApplicationData.LocalFolder-Eigenschaft, um die Dateien aus einem StorageFolder-Objekt abzurufen.


Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings
Dim localFolder As Windows.Storage.StorageFolder = Windows.Storage.ApplicationData.Current.LocalFolder

In den nächsten Abschnitten werden die Variablen localSettings und localFolder aus diesem Abschnitt verwendet.

Schreiben von Daten in eine Einstellung

Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft, um auf die Einstellungen im Container localSettings zuzugreifen, den wir im vorherigen Schritt abgerufen haben. In diesem Beispiel wird eine Einstellung namens exampleSetting erstellt.


' Simple setting

localSettings.Values("exampleSetting") = "Hello Windows";

Ein ApplicationDataCompositeValue-Objekt enthält Einstellungen, auf die atomisch zugegriffen werden muss. In diesem Beispiel wird eine Verbundeinstellung namens exampleCompositeSetting erstellt und dem Container localSettings hinzugefügt.


' Composite setting

Dim composite As New Windows.Storage.ApplicationDataCompositeValue
composite("intVal") = 1
composite("strVal") = "string";

localSettings.Values("exampleCompositeSetting") = composite

Rufen Sie die ApplicationDataContainer.CreateContainer-Methode auf, um einen Einstellungscontainer zu erstellen. In diesem Beispiel wird ein Einstellungscontainer namens exampleContainer erstellt und eine Einstellung namens exampleSetting hinzugefügt. Der Wert Always aus der ApplicationDataCreateDisposition-Enumeration gibt an, dass der Container erstellt wird, sofern er noch nicht vorhanden ist.


' 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

Lesen von Daten aus einer Einstellung

Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft, um auf die Einstellung exampleSetting im Container localSettings zuzugreifen.


' Simple setting

Dim value As Object = localSettings.Values("exampleSetting")

Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft, um auf die Einstellung exampleCompositeSetting im Container localSettings zuzugreifen.


' Composite setting

Dim composite As Windows.Storage.ApplicationDataCompositeValue = 
   CType(localSettings.Values("exampleCompositeSetting"), Windows.Storage.ApplicationDataCompositeValue)

If composite Is Nothing Then
   ' No data
Else
   ' Access data in composite("intVal") and composite("strVal")
End If

Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft, um auf die Einstellung exampleSetting im Container exampleContainer zuzugreifen.


' 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

Schreiben von Daten in eine Datei

Verwenden Sie die Datei-APIs (beispielsweise Windows.Storage.StorageFolder.CreateFileAsync und Windows.Storage.FileIO.WriteTextAsync), um eine Datei im lokalen App-Datenspeicher zu erstellen und zu aktualisieren. In diesem Beispiel wird im Container localFolder die Datei dataFile.txt erstellt, in die das aktuelle Datum und die Uhrzeit geschrieben werden. Der Wert ReplaceExisting aus der CreationCollisionOption-Enumeration gibt an, dass die Datei ersetzt werden soll, falls sie bereits vorhanden ist.

  • Applies to Windows Phone

Auf Windows Phone-Geräten werden App-Daten standardmäßig gesichert. Soll eine Datei nicht gesichert werden, speichern Sie sie im Unterordner "LocalCache" des lokalen Speichers der App.


Imports Windows.Globalization.DateTimeFormatting

Private Async Sub WriteTimestamp()
   Dim formatter As DateTimeFormatter = New DateTimeFormatter("longtime")

   Dim sampleFile As StorageFile = Await localFolder.CreateFileAsync("dataFile.txt", 
       CreationCollisionOption.ReplaceExisting)
   Await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTime.Now));
End Sub

Lesen von Daten aus einer Datei

Verwenden Sie die Datei-APIs (beispielsweise Windows.Storage.StorageFolder.GetFileAsync, Windows.Storage.StorageFile.GetFileFromApplicationUriAsync und Windows.Storage.FileIO.ReadTextAsync), um eine Datei im lokalen App-Datenspeicher zu öffnen und zu lesen. In diesem Beispiel wird die im vorherigen Schritt erstellte Datei dataFile.txt geöffnet und das Datum aus der Datei gelesen. Einzelheiten zum Laden von Dateiressourcen aus verschiedenen Speicherorten finden Sie unter So wird's gemacht: Laden von Dateiressourcen.


Private Async Function ReadTimestamp() As Task
   Try
      Dim sampleFile As StorageFile = Await localFolder.GetFileAsync("dataFile.txt")
      Dim timestamp As string = Await FileIO.ReadTtextAsync(sampleFile)
      ' Data is contained in timestamp
   Catch e1 As Exception
      ' Timestamp not found
   End Try
End Function

Löschen nicht mehr benötigter Einstellungen

Rufen Sie die ApplicationDataContainerSettings.Remove-Methode auf, um die Einstellung exampleSetting zu löschen, wenn Sie sie nicht mehr benötigen.


localSettings.Values.Remove("exampleSetting")

Rufen Sie die ApplicationDataCompositeValue.Remove-Methode auf, um die Verbundeinstellung exampleCompositeSetting zu löschen, wenn Sie sie nicht mehr benötigen.


localSettings.Values.Remove("exampleCompositeSetting")

Rufen Sie die ApplicationDataContainer.DeleteContainer-Methode auf, um den Einstellungscontainer exampleContainer zu löschen, wenn Sie ihn nicht mehr benötigen.


localSettings.DeleteContainer("exampleContainer")

Verwandte Themen

Aufgaben
So wird's gemacht: Laden von Dateiressourcen
Schnellstart: Roaming von App-Daten
Schnellstart: Temporäre App-Daten
Konzept
Zugreifen auf App-Daten mit der Windows-Runtime
Referenz
Windows.Storage.ApplicationData
Windows.Storage.ApplicationDataCompositeValue
Windows.Storage.ApplicationDataContainer
Windows.Storage.ApplicationDataContainerSettings
Beispiele
Beispiel für Anwendungsdaten

 

 

Anzeigen:
© 2014 Microsoft