ApplicationData.GetPublisherCacheFolder(String) Méthode

Définition

Espace de noms:

Windows.Storage

Obtient le sous-dossier spécifié du dossier de stockage partagé pour l’éditeur de l’application actuelle.

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

Paramètres

folderName

String

Platform::String

winrt::hstring

Sous-dossier à obtenir à partir du dossier de stockage partagé pour l’éditeur de l’application actuelle.

Retours

StorageFolder

Sous-dossier spécifié.

Remarques

Le modèle de sécurité fort de Windows Runtime application empêche généralement les applications de partager des données entre elles. Toutefois, il peut être utile pour les applications du même éditeur de partager des fichiers et des paramètres par utilisateur. Comme un éditeur, vous pouvez configurer votre application pour partager un dossier de stockage avec d’autres applications, publié en ajoutant des extensions au manifeste d’application.

Voici quelques exemples d’utilisation de ce dossier de stockage partagé si vous publiez plusieurs applications.

• Partagez des fichiers. Par exemple, si plusieurs applications utilisent les mêmes images ou les mêmes polices personnalisées, vous pouvez enregistrer ces fichiers dans le dossier de stockage partagé.
• Partagez les paramètres de l’utilisateur dans un fichier de paramètres personnalisé. Par exemple, si plusieurs applications utilisent des températures, vous pouvez enregistrer une copie de la préférence de l’utilisateur pour Celsius ou Fahrenheit dans un fichier de paramètres personnalisé dans le dossier de stockage partagé. Toutefois, nous vous recommandons de stocker les paramètres de l’utilisateur avec chaque application ou dans un autre emplacement master, car l’utilisateur peut effacer le contenu du dossier de stockage partagé. Le dossier de stockage partagé de l’éditeur de l’application est automatiquement approvisionné lorsque l’utilisateur installe la première application à partir du serveur de publication.

Le dossier de stockage partagé présente les exigences et restrictions suivantes.

• Les données du dossier de stockage partagé ne sont pas sauvegardées ou itinérantes. En outre, l’utilisateur peut effacer le contenu du dossier de stockage partagé.
• Vous ne pouvez pas utiliser cette fonctionnalité pour partager des données entre des applications de différents éditeurs.
• Vous ne pouvez pas utiliser cette fonctionnalité pour partager des données entre différents utilisateurs.
• Le dossier de stockage partagé n’a pas de gestion des versions.

Pour inscrire une application afin d’utiliser le dossier de stockage partagé de l’éditeur

Entrez manuellement du code XML similaire à l’exemple suivant dans le manifeste de l’application pour inscrire des sous-dossiers. Vous n’avez pas besoin de créer ces sous-dossiers. Ils sont automatiquement provisionnés pour vous.

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

Pour accéder aux données dans le dossier de stockage partagé de l’éditeur

Appelez la méthode GetPublisherCacheFolder pour obtenir l’un des sous-dossiers inscrits à partir du dossier de stockage partagé.

Utilisez ensuite les propriétés et les méthodes de la classe StorageFolder pour lire et écrire des fichiers et sous-dossiers dans le dossier partagé.

L’accès au dossier de stockage partagé présente les exigences et restrictions suivantes.

• Il n’existe aucun sous-dossier par défaut. Vous devez spécifier un sous-dossier lorsque vous appelez la méthode GetPublisherCacheFolder.
• Vous pouvez accéder uniquement aux sous-dossiers inscrits dans le manifeste de l’application.
• Vous ne pouvez pas accéder à la racine du dossier de stockage partagé.

Pour propre les données dans le dossier de stockage partagé de l’éditeur

Appelez la méthode ClearPublisherCacheFolderAsync pour effacer les fichiers et sous-dossiers du sous-dossier spécifié du dossier de stockage partagé pour l’éditeur de l’application actuelle.

Le dossier de stockage partagé est automatiquement nettoyé lorsque la dernière application de l’éditeur est désinstallée.

Les données enregistrées dans le dossier de stockage partagé ne sont pas liées à l’application qui les a enregistrées. Lorsque vous désinstallez l’application qui a enregistré les données, les données restent dans le dossier de stockage partagé jusqu’à ce que la dernière application du même éditeur soit désinstallée.

Voir aussi

• ClearPublisherCacheFolderAsync(String)