Aller au contenu

Fichiers et dossiers

Les sélecteurs de fichiers passent par StorageProvider, sur toutes les plateformes.

v12

OpenFileDialog, SaveFileDialog et OpenFolderDialog sont supprimés.

Récupérer le StorageProvider

var storage = TopLevel.GetTopLevel(this)!.StorageProvider;

this est n'importe quel contrôle affiché (fenêtre, UserControl…).

Ouvrir un fichier

sequenceDiagram
  participant V as Votre code
  participant S as StorageProvider
  participant OS as Sélecteur natif (OS)
  V->>S: OpenFilePickerAsync(options)
  S->>OS: affiche la boîte de dialogue
  OS-->>S: fichier choisi (ou annulation)
  S-->>V: liste de IStorageFile (vide si annulé)
  V->>V: OpenReadAsync() → Stream
Aperçu · un vrai sélecteur de fichiers du navigateur
private async void OnOuvrir(object? sender, RoutedEventArgs e)
{
    var storage = TopLevel.GetTopLevel(this)!.StorageProvider;

    var fichiers = await storage.OpenFilePickerAsync(new FilePickerOpenOptions
    {
        Title = "Ouvrir un fichier texte",
        AllowMultiple = false,
        FileTypeFilter = new[] { FilePickerFileTypes.TextPlain }
    });

    if (fichiers.Count == 0) return;   // annulé

    await using var flux = await fichiers[0].OpenReadAsync();
    using var lecteur = new StreamReader(flux);
    Editeur.Text = await lecteur.ReadToEndAsync();
}

Plusieurs fichiers, filtres personnalisés

var images = await storage.OpenFilePickerAsync(new FilePickerOpenOptions
{
    Title = "Choisir des photos",
    AllowMultiple = true,
    FileTypeFilter = new[]
    {
        FilePickerFileTypes.ImageAll,
        new FilePickerFileType("Fichiers RAW")
        {
            Patterns = new[] { "*.cr2", "*.nef", "*.arw" }
        },
        FilePickerFileTypes.All
    }
});

foreach (var image in images)
    Debug.WriteLine(image.Name);

Types prédéfinis : All, TextPlain, ImageAll, ImageJpg, ImagePng, ImageWebP, Pdf.

Type défini pour toutes les plateformes

public static readonly FilePickerFileType Csv = new("Fichiers CSV")
{
    Patterns = new[] { "*.csv" },                          // Windows, Linux
    AppleUniformTypeIdentifiers = new[] { "public.comma-separated-values-text" },  // macOS, iOS
    MimeTypes = new[] { "text/csv" }                       // Android, navigateur
};

Enregistrer

private async void OnEnregistrer(object? sender, RoutedEventArgs e)
{
    var storage = TopLevel.GetTopLevel(this)!.StorageProvider;

    var fichier = await storage.SaveFilePickerAsync(new FilePickerSaveOptions
    {
        Title = "Enregistrer sous",
        SuggestedFileName = "notes.txt",
        DefaultExtension = "txt",
        ShowOverwritePrompt = true,
        FileTypeChoices = new[] { FilePickerFileTypes.TextPlain }
    });

    if (fichier is null) return;   // annulé

    await using var flux = await fichier.OpenWriteAsync();
    await using var ecrivain = new StreamWriter(flux);
    await ecrivain.WriteAsync(Editeur.Text);
}

Choisir un dossier

var dossiers = await storage.OpenFolderPickerAsync(new FolderPickerOpenOptions
{
    Title = "Dossier d'export",
    AllowMultiple = false
});

if (dossiers.Count == 1)
{
    var dossier = dossiers[0];
    await foreach (var element in dossier.GetItemsAsync())
        Debug.WriteLine($"{element.Name} ({(element is IStorageFolder ? "dossier" : "fichier")})");
}

Créer un fichier dans le dossier choisi

var nouveau = await dossier.CreateFileAsync("export.csv");
if (nouveau is not null)
{
    await using var flux = await nouveau.OpenWriteAsync();
    await using var w = new StreamWriter(flux);
    await w.WriteLineAsync("nom;email");
}

Dossier de départ

var documents = await storage.TryGetWellKnownFolderAsync(WellKnownFolder.Documents);

await storage.OpenFilePickerAsync(new FilePickerOpenOptions
{
    SuggestedStartLocation = documents
});

WellKnownFolder : Desktop, Documents, Downloads, Music, Pictures, Videos.

Chemin local

Plateforme TryGetLocalPath() OpenReadAsync()
Windows, macOS, Linux ✅ C:\…\notes.txt ✅
Android ❌ null (URI content://) ✅
iOS ⚠️ selon l'emplacement ✅
Navigateur ❌ null ✅
string? chemin = fichier.TryGetLocalPath();   // null sur Android et navigateur

Mobile et navigateur

N'utilisez pas File.ReadAllText(chemin) : passez par OpenReadAsync() / OpenWriteAsync(), qui fonctionnent partout.

Depuis un chemin connu (desktop)

var fichier = await storage.TryGetFileFromPathAsync(@"C:\Données\config.json");

Vérifier les capacités

if (!storage.CanSave)
{
    // ex. certains navigateurs : proposer un téléchargement à la place
}

Données de l'application

Pour vos propres fichiers (réglages, cache), utilisez les dossiers .NET standard :

var dossier = Path.Combine(
    Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "MonApp");
Directory.CreateDirectory(dossier);
var reglages = Path.Combine(dossier, "reglages.json");