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¶
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
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 |
✅ |
Mobile et navigateur
N'utilisez pas File.ReadAllText(chemin) : passez par OpenReadAsync() / OpenWriteAsync(),
qui fonctionnent partout.
Depuis un chemin connu (desktop)¶
Vérifier les capacités¶
Données de l'application¶
Pour vos propres fichiers (réglages, cache), utilisez les dossiers .NET standard :