Condividi tramite

Xamarin.Essentials: Helper del file system

  • Articolo

La classe FileSystem contiene una serie di helper per trovare le directory della cache e dei dati dell'applicazione e per aprire i file all'interno del pacchetto dell'app.

Operazioni preliminari

Per iniziare a usare questa API, leggere la guida introduttiva per Xamarin.Essentials assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Uso di File System Helpers

Aggiungere un riferimento a Xamarin.Essentials nella classe :

using Xamarin.Essentials;

Per ottenere la directory dell'applicazione in cui archiviare i dati della cache. I dati della cache sono utilizzabili per tutti i dati che è necessario conservare per un periodo più lungo dei dati temporanei, ma non devono essere dati necessari per il corretto funzionamento, perché è il sistema operativo a determinare quando questa risorsa di archiviazione viene cancellata.

var cacheDir = FileSystem.CacheDirectory;

Per ottenere la directory principale dell'applicazione per tutti i file che non sono file di dati utente. Il backup di questi file viene eseguito con il framework di sincronizzazione del sistema operativo. Vedere più avanti Informazioni di implementazione specifiche della piattaforma.

var mainDir = FileSystem.AppDataDirectory;

Se si vuole aprire un file in bundle nel pacchetto dell'applicazione, è possibile usare il OpenAppPackageFileAsync metodo per leggere il contenuto. Nell'esempio seguente è stato aggiunto un file denominato mybundledfile.txt a ogni piattaforma. Per informazioni dettagliate, vedere la sezione relativa alle specifiche dell'implementazione della piattaforma.

 var fileName = "mybundledfile.txt";
 using (var stream = await FileSystem.OpenAppPackageFileAsync(fileName))
 {
    using (var reader = new StreamReader(stream))
    {
        var fileContents = await reader.ReadToEndAsync();
    }
 }

Informazioni di implementazione specifiche della piattaforma

  • CacheDirectory: restituisce l'elemento CacheDir del contesto corrente.
  • AppDataDirectory: restituisce l'elemento FilesDir del contesto corrente e il backup viene eseguito usando il backup automatico a partire dall'API 23 e versioni successive.

Aggiungere i file nella cartella Assets del progetto Android e contrassegnare l'azione di compilazione come AndroidAsset per usarla con OpenAppPackageFileAsync.

API

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.