File, cartelle e librerie con Windows App SDK
Le app di Windows App SDK in pacchetto possono sfruttare le potenti API fornite dagli spazi dei nomi Windows.Storage, Windows.Storage.Streams e Windows.Storage.Pickers per leggere e scrivere in modo efficiente vari formati di dati nei file, nonché gestire file e cartelle. Questa sezione illustra argomenti essenziali come la lettura e la scrittura delle impostazioni dell'app, le selezioni file e cartelle e l'accesso a posizioni speciali in modalità sandbox, ad esempio la libreria Video/Musica. Informazioni su come ottimizzare le funzionalità di gestione dei file dell'app con Windows App SDK.
Windows 10 e versioni successive del sistema operativo offrono un'ampia gamma di API correlate a file, cartelle, librerie e impostazioni per le app. Queste funzionalità sono disponibili tramite una combinazione di API WinRT e .NET fornite da Windows SDK e .NET SDK.
Le app in pacchetto hanno accesso a tutte le API di archiviazione WinRT disponibili per le app UWP. Sia che si stia eseguendo la migrazione di un'app UWP esistente o creando una nuova app, è possibile usare queste API per leggere e scrivere i dati. Per esempi di uso delle API di archiviazione in un'app WinUI, vedere Accedere a file e cartelle con Windows App SDK e API WinRT.
Oltre alle API WinRT, le app in pacchetto possono usare le API .NET nello spazio dei nomi System.IO per leggere e scrivere i dati. Quando viene creato un nuovo progetto WinUI 3, il relativo file Package.appxmanifest
contiene l'impostazione seguente:
<Capabilities>
<rescap:Capability Name="runFullTrust" />
</Capabilities>
La dichiarazione di questa funzionalità limitata fornisce accesso completo al file system, al Registro di sistema e ad altre funzionalità limitate. Per altre informazioni, vedere Dichiarazioni di funzionalità limitate. In altre parole, l'app dispone dello stesso accesso al file system di qualsiasi altra app desktop .NET quando usa le API di file .NET.
Per esempi di uso delle API .NET in un'app WinUI, vedere Accedere a file e cartelle con Windows App SDK e API .NET.
Se si sviluppano app WinUI in pacchetto, le API di archiviazione WinRT possono essere uno strumento potente per la lettura e la scrittura di dati. Gli argomenti UWP seguenti forniscono un'ampia gamma di informazioni per gli sviluppatori che cercano di sfruttare queste API nelle app.
Argomento | Descrizione |
---|---|
Enumerare file e cartelle ed eseguire query su di essi | Puoi accedere a file e cartelle che si trovano in una cartella, una raccolta, un dispositivo o un percorso di rete. È anche possibile eseguire query su file e cartelle in una posizione tramite la creazione di query di file e cartelle. |
Creare, scrivere e leggere un file | Leggere e scrivere un file usando un oggetto StorageFile. |
Procedure consigliate per la scrittura su file | Segui le procedure consigliate per l'uso di vari metodi di scrittura delle classi FileIO e PathIO. |
Ottenere le proprietà del file | Puoi ottenere le proprietà (di livello superiore, di base ed estese) per i file rappresentati da oggetti StorageFile. |
Aprire file e cartelle con una selezione | Accedi a file e cartelle permettendo all'utente di interagire con una selezione. Puoi usare FolderPicker per ottenere l’accesso a una cartella. NOTA: in un'app desktop, che include app WinUI 3, è possibile usare selezioni file e cartelle da Windows.Storage.Pickers. Tuttavia, se l'app desktop richiede l'elevazione per l'esecuzione, è necessario un approccio diverso perché queste API non sono progettate per essere usate in un'app con privilegi elevati. Per un esempio, vedere FileSavePicker. |
Salvare un file con una selezione | Usa FileSavePicker per permettere agli utenti di specificare il nome e il percorso in cui vogliono che l'app salvi un file. |
Accesso al contenuto del Gruppo Home | Puoi accedere al contenuto archiviato nella cartella Gruppo Home dell'utente, che include immagini, musica e video. |
Determinazione della disponibilità dei file di Microsoft OneDrive | Determinare se un file di Microsoft OneDrive è disponibile usando la proprietà StorageFile.IsAvailable. |
File e cartelle nelle raccolte Musica, Immagini e Video | Aggiungere cartelle esistenti di musica, immagini o video alle librerie corrispondenti. Puoi anche rimuovere cartelle dalle raccolte, ottenere l'elenco di cartelle in una raccolta e scoprire foto, musica e video archiviati. |
Tenere traccia di cartelle e file usati di recente | Tenere traccia dei file a cui l'utente accede di frequente aggiungendoli all'elenco degli ultimi elementi usati dell'app (MRU). La piattaforma gestisce automaticamente il MRU tramite l'ordinamento degli elementi in base all'ultimo accesso e rimuovendo l'elemento meno recente quando viene raggiunto il limite di 25 elementi dell'elenco. Tutte le app hanno il proprio MRU. |
Tenere traccia delle modifiche al file system in background | Puoi tenere traccia delle modifiche apportate al file system anche quando l'app non è in esecuzione. |
Accedere alla scheda SD | Puoi archiviare dati non essenziali su una scheda micro SD facoltativa e quindi accedervi, in particolare, nei dispositivi mobili a basso costo in cui lo spazio di archiviazione interno è limitato. |
Accesso rapido alle proprietà del file | Raccogliere in modo efficiente un elenco di file e le relative proprietà da una libreria da usare tramite le API di Windows Runtime. |
Accedere a file e cartelle con Windows App SDK e API WinRT
Feedback su Windows developer
Windows developer è un progetto di open source. Selezionare un collegamento per fornire feedback: