ApplicationData.GetPublisherCacheFolder(String) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Ottiene la sottocartella specificata della cartella di archiviazione condivisa per l'autore dell'app corrente.

public:
 virtual StorageFolder ^ GetPublisherCacheFolder(Platform::String ^ folderName) = GetPublisherCacheFolder;

StorageFolder GetPublisherCacheFolder(winrt::hstring const& folderName);

public StorageFolder GetPublisherCacheFolder(string folderName);

function getPublisherCacheFolder(folderName)

Public Function GetPublisherCacheFolder (folderName As String) As StorageFolder

Parametri

folderName

String

Platform::String

winrt::hstring

Sottocartella da ottenere dalla cartella di archiviazione condivisa per l'editore dell'app corrente.

Restituisce

StorageFolder

Sottocartella specificata.

Commenti

Il modello di sicurezza sicuro di Windows Runtime'app impedisce in genere alle app di condividere i dati tra loro. Può essere utile, tuttavia, per le app dello stesso editore condividere file e impostazioni in base all'utente. In qualità di autore di un'app, puoi registrarla per condividere una cartella di archiviazione con altre app da te pubblicate, aggiungendo estensioni nel manifesto dell'app.

Ecco alcuni esempi di come è possibile usare questa cartella di archiviazione condivisa se si pubblicano più app.

• Condividere file. Ad esempio, se più app usano le stesse immagini o gli stessi tipi di carattere personalizzati, è possibile salvare questi file nella cartella di archiviazione condivisa.
• Condividere le impostazioni dell'utente in un file di impostazioni personalizzate. Ad esempio, se più app usano temperature, è possibile salvare una copia della preferenza dell'utente per Celsius o Fahrenheit in un file di impostazioni personalizzate nella cartella di archiviazione condivisa. È consigliabile archiviare anche le impostazioni dell'utente con ogni app o in un'altra posizione master, poiché l'utente può cancellare il contenuto della cartella di archiviazione condivisa. Il provisioning della cartella di archiviazione condivisa per l'autore dell'app viene eseguito automaticamente quando l'utente installa la prima app dal server di pubblicazione.

La cartella di archiviazione condivisa presenta i requisiti e le restrizioni seguenti.

• I dati nella cartella di archiviazione condivisa non vengono sottoposti a backup o sottoposti a roaming. Inoltre, l'utente può cancellare il contenuto della cartella di archiviazione condivisa.
• Non è possibile usare questa funzionalità per condividere i dati tra app di server di pubblicazione diversi.
• Non è possibile usare questa funzionalità per condividere i dati tra utenti diversi.
• La cartella di archiviazione condivisa non dispone della gestione delle versioni.

Per registrare un'app per usare la cartella di archiviazione condivisa del server di pubblicazione

Immettere manualmente codice XML simile all'esempio seguente nel manifesto dell'app per registrare le sottocartelle. Non è necessario creare queste sottocartelle. Viene effettuato automaticamente il provisioning.

<Package>
    …
    <Extensions>
        …
        <Extension Category="windows.publisherCacheFolders">
            <PublisherCacheFolders>
                <Folder Name="Folder1"/>
                <Folder Name="Folder2"/>
            </PublisherCacheFolders>
        </Extension>
        …
    </Extensions>
    …
</Package>

Per accedere ai dati nella cartella di archiviazione condivisa dell'editore

Chiamare il metodo GetPublisherCacheFolder per ottenere una delle sottocartelle registrate dalla cartella di archiviazione condivisa.

Usare quindi le proprietà e i metodi della classe StorageFolder per leggere e scrivere file e sottocartelle nella cartella condivisa.

L'accesso alla cartella di archiviazione condivisa prevede i requisiti e le restrizioni seguenti.

• Non esiste alcuna sottocartella predefinita. È necessario specificare una sottocartella quando si chiama il metodo GetPublisherCacheFolder.
• È possibile accedere solo alle sottocartelle registrate nel manifesto dell'app.
• Non è possibile accedere alla radice della cartella di archiviazione condivisa.

Per pulire i dati nella cartella di archiviazione condivisa del server di pubblicazione

Chiamare il metodo ClearPublisherCacheFolderAsync per cancellare i file e le sottocartelle dalla sottocartella specificata della cartella di archiviazione condivisa per l'autore dell'app corrente.

La cartella di archiviazione condivisa viene pulita automaticamente quando viene disinstallata l'ultima app dal server di pubblicazione.

I dati salvati nella cartella di archiviazione condivisa non sono collegati all'app che l'ha salvata. Quando si disinstalla l'app che ha salvato i dati, i dati rimangono nella cartella di archiviazione condivisa fino a quando non viene disinstallata l'ultima app dallo stesso editore.

Vedi anche

• ClearPublisherCacheFolderAsync(String)