Guida introduttiva: Integrazione con i contratti selettore file (app di Windows Runtime)

Articolo
12/11/2015

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Puoi offrire accesso ai contenuti dell'app, un percorso di salvataggio oppure aggiornamenti dei file tramite selezione file integrando i contratti di selezione per apertura file, di selezione per salvataggio file e di aggiornamento dei file in cache.

Prerequisiti

JavaScript: Come attivare un'app
C#/C++/VB: Come attivare un'app
Argomento consigliato: Contratti per app Windows

Scegliere i servizi offerti dall'app nelle finestre di selezione file

La tua app può offrire i servizi seguenti ad altre app integrando il contratto per app associato. Per partecipare a un contratto, devi dichiararlo nel manifesto dell'app, rispondere all'evento attivato corrispondente e creare una visualizzazione app specializzata.

Consentire l'accesso ai file

Puoi consentire l'accesso ai file da una selezione file se la tua app include una visualizzazione speciale e/o utile di tali file o se gli utenti non riescono ad accedere facilmente ai file in altro modo.

Contratto per app: contratto di selezione per apertura file

Informazioni sull'evento attivato: fileOpenPickerActivatedEventArgs

Offrire un percorso di salvataggio

Puoi offrire un percorso di salvataggio tramite selezione file se prevedi che gli utenti vogliano salvare i file per poterli aprire e gestire successivamente nella tua app.

Contratto per app: contratto di selezione per salvataggio file

Informazioni sull'evento attivato: fileSavePickerActivatedEventArgs

Offrire aggiornamenti in tempo reale per i file

Puoi tenere traccia dei file e aggiornarli tramite una selezione file se prevedi che gli utenti usino l'app come archivio centrale di file cui l'app consente l'accesso o che vengono salvati usando l'app come percorso di salvataggio.

Contratto per app: contratto di aggiornamento dei file nella cache

Informazioni sull'evento attivato: cachedFileUpdaterActivatedEventArgs

Per informazioni sui servizi offerti dall'app tramite una selezione, vedi Accesso a file con selezione file.

Dichiarare il contratto nel manifesto dell'app

Apri il progetto in Microsoft Visual Studio e segui questi passaggi per aggiungere un contratto per app al manifesto:

Per aggiungere un contratto per app, visualizza la finestra Aggiungi nuovo elemento per il tuo progetto, seleziona il contratto nel riquadro centrale e fai clic sul pulsante Aggiungi.

Puoi visualizzare la finestra Aggiungi nuovo elemento in Visual Studio in diversi modi:
- Selezionando l'opzione di menu Progetto > Aggiungi nuovo elemento
- Selezionando l'opzione di menu Aggiungi > Nuovo elemento nel menu di scelta rapida del progetto
- Usando il tasto di scelta rapida CTRL+MAIUSC+A
Suggerimento Quando aggiungi questi contratti, Visual Studio aggiorna automaticamente il file manifesto "package.appmanifest" e aggiunge i file al progetto usato per definire il layout e il comportamento della visualizzazione che verrà ospitata nella finestra di selezione file durante la chiamata al servizio dell'app.
Personalizza le impostazioni del contratto in Visual Studio se quelle predefinite non sono appropriate per la tua app.
1. Apri "package.appmanifest".
2. Apri la scheda Dichiarazioni.
3. Seleziona il nome del contratto nell'elenco Dichiarazioni supportate.
4. Aggiungi il supporto per tipi di file specifici.
  
  Nella casella Tipi di file supportati deselezionare la casella di controllo SupportsAnyFileType.
  
  Aggiungi un nuovo campo FileType per ogni tipo di file che vuoi supportare:
  1. Fai clic sul pulsante Aggiungi nuovo.
  2. Immetti l'estensione di un tipo di file che vuoi supportare nel campo FileType, ad esempio: *.ext
  Suggerimento Aggiungi solo i tipi di file pertinenti per la tua app, per gli utenti e per il contratto. Limitando i tipi di file supportati in questo modo, la visualizzazione della selezione file sarà più chiara e semplice da usare.
Per rimuovere il supporto per un tipo di file, segui i passaggi precedenti e fai clic sul pulsante Rimuovi del tipo da rimuovere. Il pulsante Rimuovi si trova proprio sopra il campo FileType.

Il file manifesto viene aggiornato con il markup del contratto aggiunto. Un elemento che rappresenta il contratto aggiunto viene inserito nel markup XML del manifesto come figlio dell'elemento Extensions. Ad esempio, il markup di un contratto di contratto di selezione per apertura file che supporta tutti i tipi di file è simile al seguente:


  <Extension Category="windows.filePicker" StartPage="filePicker.html">
    <FileOpenPicker>
      <SupportedFileTypes SupportsAnyFileType="true" />
    </FileOpenPicker>
  </Extension>

Rispondere quando l'app viene attivata da una selezione file

Aggiungi al gestore eventi attivato il codice per testare che l'oggetto passato al gestore sia associato al contratto dichiarato nel manifesto e quindi aprire la visualizzazione di selezione file dell'app.

A ogni contratto è associato un oggetto che fornisce informazioni su un evento che viene attivato quando una selezione file chiama uno dei servizi offerti dall'app.

Contratto di selezione per apertura file - fileOpenPickerActivatedEventArgs

Contratto di selezione per salvataggio file - fileSavePickerActivatedEventArgs

Contratto di aggiornamento dei file nella cache - cachedFileUpdaterActivatedEventArgs

Creare una visualizzazione specializzata dell'app che verrà ospitata nella selezione file

Le informazioni incluse in Linee guida ed elenco di controllo per selezioni file ti saranno utili per progettare la visualizzazione app ospitata nella selezione file.

In ultima analisi la tua visualizzazione deve comprendere:

Codice per personalizzare adeguatamente il formato 16:9 della selezione file
Markup e stili che definiscono il layout dell'area del riquadro della selezione file (in cui sono visualizzati i file)
Codice per associare l'origine dati al markup e consentire la visualizzazione dei file nell'area del riquadro

Testare i servizi offerti tramite l'app da una selezione file chiamata da un'altra app

Per testare i servizi che la tua app offre da una selezione file, devi attivare l'evento attivato corrispondente al servizio offerto. Non puoi attivare questo evento eseguendo direttamente la tua app.

Segui invece questi passaggi per attivare l'evento attivato corrispondente per ogni contratto.

Per testare la partecipazione dell'app al contratto di selezione per apertura file:

Avvia un'app diversa dalla tua.
Usa l'interfaccia utente dell'altra app per chiamare una finestra di selezione file e accedere ai file.
Seleziona la tua app nell'elenco di percorso della selezione file per visualizzare l'app ospitata nella selezione file.

Per testare la partecipazione dell'app al contratto di selezione per salvataggio file:

Avvia un'app diversa dalla tua.
Usa l'interfaccia utente dell'altra app per chiamare una finestra di selezione file e salvare un file.
Seleziona la tua app nell'elenco di percorso della selezione file per visualizzare l'app ospitata nella selezione file.

Per testare la partecipazione dell'app al contratto di aggiornamento dei file nella cache:

Avvia un'app diversa dalla tua.
Usa l'interfaccia utente dell'altra app per chiamare una finestra di selezione file e accedere o salvare un file contrassegnato per l'aggiornamento.

Riepilogo

La tua app può offrire servizi ad altre app partecipando a un contratto per app. Per partecipare a un contratto, devi dichiararlo nel manifesto dell'app, rispondere all'evento attivato corrispondente e creare una visualizzazione app specializzata.