Helpers voor bestandssysteem

Het voorbeeld bekijken.

In dit artikel wordt beschreven hoe u de interface voor .NET Multi-Platform App UI (.NET MAUI) IFileSystem kunt gebruiken. Deze interface biedt helpermethoden voor toegang tot de cache en gegevensmappen van de app en helpt toegang te krijgen tot bestanden in het app-pakket.

De standaard implementatie van de IFileSystem interface is beschikbaar via de FileSystem.Current eigenschap. Zowel de IFileSystem interface als FileSystem de klasse bevinden zich in de Microsoft.Maui.Storage naamruimte.

Helpers voor bestandssysteem gebruiken

Elk besturingssysteem heeft unieke paden naar de app-cache en app-gegevensmappen. De IFileSystem interface biedt een platformoverschrijdende API voor toegang tot deze mappaden.

Cachemapdirectory

De map van de toepassing ophalen om cachegegevens op te slaan. Cachegegevens kunnen worden gebruikt voor alle gegevens die langer moeten worden bewaard dan tijdelijke gegevens, maar mogen geen gegevens zijn die nodig zijn om de app te gebruiken, omdat het besturingssysteem deze opslag mogelijk wist.

string cacheDir = FileSystem.Current.CacheDirectory;

App-gegevensmap

Om de bovenliggende map van de app te vinden voor bestanden die geen gebruikersbestanden zijn. Er wordt een back-up van deze bestanden gemaakt met het synchronisatieframework van het besturingssysteem.

string mainDir = FileSystem.Current.AppDataDirectory;

Gebundelde bestanden

Als u een bestand wilt openen dat is gebundeld in het app-pakket, gebruikt u de OpenAppPackageFileAsync methode en geeft u de bestandsnaam door. Deze methode geeft een alleen-lezen Stream terug die de bestandsinhoud vertegenwoordigt. In het volgende voorbeeld ziet u hoe u de tekstinhoud van een bestand kunt lezen met behulp van een methode:

public async Task<string> ReadTextFile(string filePath)
{
    using Stream fileStream = await FileSystem.Current.OpenAppPackageFileAsync(filePath);
    using StreamReader reader = new StreamReader(fileStream);

    return await reader.ReadToEndAsync();
}

In het volgende voorbeeld ziet u hoe u een gebundeld lettertypebestand opent vanuit het app-pakket:

await using var myFont = await FileSystem.OpenAppPackageFileAsync("MyFont.ttf");

Een gebundeld bestand kopiëren naar de map met app-gegevens

U kunt het gebundelde bestand van een app niet wijzigen. Maar u kunt een gebundeld bestand kopiëren naar de cachemap of app-gegevensmap. In het volgende voorbeeld wordt een OpenAppPackageFileAsync gebundeld bestand gekopieerd naar de map met app-gegevens:

public async Task CopyFileToAppDataDirectory(string filename)
{
    // Open the source file
    using Stream inputStream = await FileSystem.Current.OpenAppPackageFileAsync(filename);

    // Create an output filename
    string targetFile = Path.Combine(FileSystem.Current.AppDataDirectory, filename);

    // Copy the file to the AppDataDirectory
    using FileStream outputStream = File.Create(targetFile);
    await inputStream.CopyToAsync(outputStream);
}

Platformverschillen

In deze sectie worden de platformspecifieke verschillen met de helpers van het bestandssysteem beschreven.