Autorizzazioni di accesso ai file

Le app della piattaforma UWP (Universal Windows Platform) possono accedere a determinati percorsi nel file system per impostazione predefinita. Le app possono anche accedere ad altri percorsi tramite la selezione file o la dichiarazione delle funzionalità.

Percorsi accessibili dalle app UWP

Quando si crea una nuova app, è possibile accedere per impostazione predefinita ai percorsi seguenti nel file system:

Directory di installazione dell'applicazione

Cartella in cui viene installata l'app nel sistema dell'utente.

Ci sono due modi principali per accedere a file e cartelle nella directory di installazione dell'app:

1. È possibile recuperare un oggetto StorageFolder che rappresenta la directory di installazione dell'app, come in questo modo:

   Windows.Storage.StorageFolder installedLocation = Windows.ApplicationModel.Package.Current.InstalledLocation;
   

   var installDirectory = Windows.ApplicationModel.Package.current.installedLocation;
   

   #include <winrt/Windows.Storage.h>
   ...
   Windows::Storage::StorageFolder installedLocation{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
   

   Windows::Storage::StorageFolder^ installedLocation = Windows::ApplicationModel::Package::Current->InstalledLocation;
   

   SI può quindi accedere ai file e alle cartelle della directory usando i metodi StorageFolder. In questo esempio l'oggetto StorageFolder è archiviato nella variabile installDirectory. Per altre informazioni su come utilizzare il pacchetto e la directory di installazione dell'app con l'esempio di informazioni del pacchetto di un app su GitHub.

2. È possibile recuperare un file direttamente dalla directory di installazione dell'app mediante un URI, nel modo seguente:

   using Windows.Storage;            
   StorageFile file = await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appx:///file.txt"));
   

   Windows.Storage.StorageFile.getFileFromApplicationUriAsync("ms-appx:///file.txt").done(
       function(file) {
           // Process file
       }
   );
   

   Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
   {
       Windows::Storage::StorageFile file{
           co_await Windows::Storage::StorageFile::GetFileFromApplicationUriAsync(Windows::Foundation::Uri{L"ms-appx:///file.txt"})
       };
       // Process file
   }
   

   auto getFileTask = create_task(StorageFile::GetFileFromApplicationUriAsync(ref new Uri("ms-appx:///file.txt")));
   getFileTask.then([](StorageFile^ file) 
   {
       // Process file
   });
   

   Al termine di GetFileFromApplicationUriAsync viene restituito un oggetto StorageFile che rappresenta il file file.txt nella directory di installazione dell'app (file nell'esempio).

   Il prefisso "ms-appx:///" nell'URI fa riferimento alla directory di installazione dell'app. Per altre informazioni sull'uso degli URI delle app, vedere Come usare gli URI per fare riferimento ai contenuti.

Inoltre, a differenza di altri percorsi, è possibile accedere ai file nella directory di installazione dell'app anche con alcune API Win32 e COM per app della piattaforma UWP (Universal Windows Platform) e alcune funzioni della libreria Standard C/C++ di Microsoft Visual Studio.

La directory di installazione dell'app è un percorso di sola lettura. Non è possibile ottenere accesso alla directory di installazione tramite la selezione file.

Accedere ai percorsi dei dati dell'applicazione

Cartelle in cui possono essere archiviati i dati dell'app. Queste cartelle (locale, roaming e temporanea) vengono create durante l'installazione dell'app.

Esistono due modi principali per accedere a file e cartelle nei percorsi dei dati dell'app:

1. Usare le proprietà ApplicationData per recuperare la cartella dati di un'app.

   Si può ad esempio usare ApplicationData.LocalFolder per recuperare un oggetto StorageFolder che rappresenta la cartella locale dell'app in questo modo:

   using Windows.Storage;
   StorageFolder localFolder = ApplicationData.Current.LocalFolder;
   

   var localFolder = Windows.Storage.ApplicationData.current.localFolder;
   

   Windows::Storage::StorageFolder storageFolder{
       Windows::Storage::ApplicationData::Current().LocalFolder()
   };
   

   using namespace Windows::Storage;
   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   

   Se si vuole accedere alla cartella roaming o temporanea dell'app, usare invece la proprietà RoamingFolder o TemporaryFolder.

   Dopo aver recuperato un oggetto StorageFolder che rappresenta un percorso dei dati dell'app, è possibile accedere ai file e alle cartelle nel percorso in questione mediante i metodi StorageFolder. Nell'esempio questi oggetti StorageFolder sono archiviati nella variabile localFolder. Per altre informazioni sull'utilizzo dei percorsi dei dati dell'app dalle indicazioni contenute nella pagina Classe ApplicationData pagina e scaricando l'esempio di dati dell'applicazione da GitHub.

2. È possibile recuperare un file direttamente dalla cartella locale dell'app mediante un URI, nel modo seguente:

   using Windows.Storage;
   StorageFile file = await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appdata:///local/file.txt"));
   

   Windows.Storage.StorageFile.getFileFromApplicationUriAsync("ms-appdata:///local/file.txt").done(
       function(file) {
           // Process file
       }
   );
   

   Windows::Storage::StorageFile file{
       co_await Windows::Storage::StorageFile::GetFileFromApplicationUriAsync(Windows::Foundation::Uri{ L"ms-appdata:///local/file.txt" })
   };
   // Process file
   

   using Windows::Storage;
   auto getFileTask = create_task(StorageFile::GetFileFromApplicationUriAsync(ref new Uri("ms-appdata:///local/file.txt")));
   getFileTask.then([](StorageFile^ file) 
   {
       // Process file
   });
   

   Al termine di GetFileFromApplicationUriAsync viene restituito un oggetto StorageFile che rappresenta il file file.txt nella cartella locale dell'app (file nell'esempio).

   Il prefisso "ms-appdata:///local/" nell'URI fa riferimento alla cartella locale dell'app. Per accedere ai file nelle cartelle roaming o temporanee di un'app, usare invece "ms-appdata:///roaming/" o "ms-appdata:///temporary/". Per altre informazioni sull'uso di URI delle app, vedere Come caricare risorse di file.

Inoltre, a differenza di altri percorsi, si può accedere ai file nei percorsi dei dati dell'app anche usando alcune API Win32 e COM per app della piattaforma UWP (Universal Windows Platform) e alcune funzioni della libreria Standard C/C++ di Microsoft Visual Studio.

Non è possibile accedere alle cartelle locali, roaming e temporanee tramite la selezione file.

Accedere ai dispositivi rimovibili

L'app può anche accedere per impostazione predefinita ad alcuni file nei dispositivi connessi. Questo è possibile se l'app usa l'estensione AutoPlay per l'avvio automatico quando gli utenti connettono un dispositivo al sistema, ad esempio una fotocamera o una chiavetta USB. I file a cui l'app può accedere sono limitati a tipi specifici impostati tramite le dichiarazioni delle associazioni dei tipi di file nel manifesto dell'app.

Ovviamente, è anche possibile accedere ai file e alle cartelle in un dispositivo rimovibile chiamando il selettore file (mediante FileOpenPicker e FolderPicker) e permettendo all'utente di selezionare i file e le cartelle a cui accedere con l'app. Per scoprire come usare la selezione file, vedere Aprire file e cartelle con una selezione.

Cartella Download dell'utente

Cartella in cui vengono salvati i file scaricati per impostazione predefinita.

Per impostazione predefinita, l'app può accedere solo ai file e alle cartelle all'interno della cartella Download dell'utente creata dall'app stessa. È tuttavia possibile ottenere accesso a file e cartelle nella cartella Download dell'utente chiamando un selettore file (FileOpenPicker o FolderPicker) in modo che gli utenti possano individuare e selezionare i file e le cartelle a cui accedere tramite l'app.

• È possibile creare un file nella cartella Download dell'utente come segue:

  using Windows.Storage;
  StorageFile newFile = await DownloadsFolder.CreateFileAsync("file.txt");
  

  Windows.Storage.DownloadsFolder.createFileAsync("file.txt").done(
      function(newFile) {
          // Process file
      }
  );
  

  Windows::Storage::StorageFile newFile{
      co_await Windows::Storage::DownloadsFolder::CreateFileAsync(L"file.txt")
  };
  // Process file
  

  using Windows::Storage;
  auto createFileTask = create_task(DownloadsFolder::CreateFileAsync(L"file.txt"));
  createFileTask.then([](StorageFile^ newFile)
  {
      // Process file
  });
  

  DownloadsFolder.CreateFileAsync è in overload, per cui è possibile specificare le azioni che devono essere eseguite dal sistema se nella cartella Download è già presente un file con lo stesso nome. Dopo il completamento dei metodi viene restituito un oggetto StorageFile che rappresenta il file creato. Questo file è denominato newFile nell'esempio.

• È possibile creare una sottocartella nella cartella Download dell'utente in questo modo:

  using Windows.Storage;
  StorageFolder newFolder = await DownloadsFolder.CreateFolderAsync("New Folder");
  

  Windows.Storage.DownloadsFolder.createFolderAsync("New Folder").done(
      function(newFolder) {
          // Process folder
      }
  );
  

  Windows::Storage::StorageFolder newFolder{
      co_await Windows::Storage::DownloadsFolder::CreateFolderAsync(L"New Folder")
  };
  // Process folder
  

  using Windows::Storage;
  auto createFolderTask = create_task(DownloadsFolder::CreateFolderAsync(L"New Folder"));
  createFolderTask.then([](StorageFolder^ newFolder)
  {
      // Process folder
  });
  

  DownloadsFolder.CreateFolderAsync è in overload, per cui è possibile specificare le azioni che devono essere eseguite dal sistema se nella cartella Download è già presente una sottocartella con lo stesso nome. Dopo il completamento dei metodi viene restituito un oggetto StorageFolder che rappresenta la sottocartella creata. Questo file è denominato newFolder nell'esempio.

Accesso ad altri percorsi

Oltre ai percorsi predefiniti, un'app può accedere ad altri file e cartelle dichiarando le funzionalità nel proprio manifesto oppure chiamando una selezione file per permettere all'utente di selezionare file e cartelle a cui accedere con l'app.

Le app che dichiarano l'estensione AppExecutionAlias ottengono le autorizzazioni per il file system dalla directory da cui vengono avviate nella finestra della console e verso il basso.

Conservazione dell'accesso a file e cartelle

Quando l'app recupera una cartella o un file tramite uno strumento di selezione, un'attivazione di file, un'operazione di trascinamento della selezione e così via, può accedere a tale cartella o file solo finché non viene terminata. Se si vuole accedere automaticamente alla cartella o al file in futuro, è possibile aggiungere l'elemento a FutureAccessList in modo che l'app possa accedervi immediatamente in futuro. È inoltre possibile usare MostRecentlyUsedList per gestire facilmente un elenco dei file usati di recente.

Funzionalità per l'accesso ad altri percorsi

La tabella seguente contiene gli altri percorsi cui puoi accedere dichiarando una o più funzionalità e usando l'API Windows.Storage associata.

Esempio

In questo esempio viene aggiunta la funzionalità broadFileSystemAccess con restrizioni. Oltre a specificare la funzionalità, il rescap dello spazio dei nomi deve essere aggiunto e viene inoltre aggiunto a IgnorableNamespaces.

<Package
  ...
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="uap mp rescap">
...
<Capabilities>
    <rescap:Capability Name="broadFileSystemAccess" />
</Capabilities>