Xamarin.Essentials: DateisystemhilfsprogrammeXamarin.Essentials: File System Helpers

Die Klasse FileSystem enthält eine Reihe von Hilfsprogrammen, um den Cache und die Datenverzeichnisse der Anwendung zu finden und Dateien im App-Paket zu öffnen.The FileSystem class contains a series of helpers to find the application's cache and data directories and open files inside of the app package.

Erste SchritteGet started

Lesen Sie zum Einstieg in diese API das Handbuch Erste Schritte mit Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Verwenden der DateisystemhilfsprogrammeUsing File System Helpers

Fügen Sie Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

So rufen Sie das Anwendungsverzeichnis zum Speichern von Cachedaten ab.To get the application's directory to store cache data. Cachedaten können für alle Daten verwendet werden, die länger als temporäre Daten aufbewahrt werden müssen. Dabei sollte es sich aber nicht um Daten handeln, die für den ordnungsgemäßen Betrieb erforderlich sind, da das Betriebssystem vorgibt, wann dieser Speicher gelöscht wird.Cache data can be used for any data that needs to persist longer than temporary data, but should not be data that is required to properly operate, as the OS dictates when this storage is cleared.

var cacheDir = FileSystem.CacheDirectory;

So rufen Sie das oberste Anwendungsverzeichnis für alle Dateien ab, die keine Benutzerdatendateien sind.To get the application's top-level directory for any files that are not user data files. Diese Dateien werden über das Synchronisierungsframework des Betriebssystems gesichert.These files are backed up with the operating system syncing framework. Die Besonderheiten bei der plattformspezifischen Implementierung sind weiter unten beschrieben.See Platform Implementation Specifics below.

var mainDir = FileSystem.AppDataDirectory;

So öffnen Sie eine Datei, die im Anwendungspaket gebündelt ist:To open a file that is bundled into the application package:

 using (var stream = await FileSystem.OpenAppPackageFileAsync(templateFileName))
 {
    using (var reader = new StreamReader(stream))
    {
        var fileContents = await reader.ReadToEndAsync();
    }
 }

Besonderheiten bei der plattformspezifischen ImplementierungPlatform Implementation Specifics

  • CacheDirectory: Gibt das Verzeichnis CacheDir des aktuellen Kontexts zurück.CacheDirectory – Returns the CacheDir of the current context.
  • AppDataDirectory: Gibt das Verzeichnis FilesDir des aktuellen Kontexts zurück. Die Sicherung erfolgt mit der automatischen Sicherung ab API-Ebene 23 und höher.AppDataDirectory – Returns the FilesDir of the current context and are backed up using Auto Backup starting on API 23 and above.

Fügen Sie eine beliebige Datei zum Ordner Assets im Android Projekt hinzu, und markieren Sie den Buildvorgang als AndroidAsset, um ihn mit OpenAppPackageFileAsync zu verwenden.Add any file into the Assets folder in the Android project and mark the Build Action as AndroidAsset to use it with OpenAppPackageFileAsync.

APIAPI