ApplicationData.GetPublisherCacheFolder(String) Método

Definição

Namespace:

Windows.Storage

Obtém a subpasta especificada da pasta de armazenamento compartilhado para o editor do aplicativo atual.

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

Parâmetros

folderName

String

Platform::String

winrt::hstring

A subpasta a ser obtido da pasta de armazenamento compartilhado para o editor do aplicativo atual.

Retornos

StorageFolder

A subpasta especificada.

Comentários

O forte modelo de segurança de Windows Runtime aplicativo normalmente impede que aplicativos compartilhem dados entre si. No entanto, pode ser útil para aplicativos do mesmo editor compartilharem arquivos e configurações por usuário. Como fornecedor de aplicativos, você pode registrar seu aplicativo para compartilhar uma pasta de armazenamento com outros aplicativos que publica. Basta adicionar extensões no manifesto do aplicativo.

Aqui estão alguns exemplos de como você pode usar essa pasta de armazenamento compartilhado se publicar vários aplicativos.

• Compartilhar arquivos. Por exemplo, se vários aplicativos usarem as mesmas imagens ou as mesmas fontes personalizadas, você poderá salvar esses arquivos na pasta de armazenamento compartilhado.
• Compartilhe as configurações do usuário em um arquivo de configurações personalizado. Por exemplo, se vários aplicativos usarem temperaturas, você poderá salvar uma cópia da preferência do usuário para Celsius ou Fahrenheit em um arquivo de configurações personalizado na pasta de armazenamento compartilhado. Recomendamos que você também armazene as configurações do usuário com cada aplicativo ou em outro master local, no entanto, já que o usuário pode limpar o conteúdo da pasta de armazenamento compartilhado. A pasta de armazenamento compartilhado do editor de aplicativos é provisionada automaticamente quando o usuário instala o primeiro aplicativo do publicador.

A pasta de armazenamento compartilhado tem os seguintes requisitos e restrições.

• Os dados na pasta de armazenamento compartilhado não são copiados em backup ou perambulados. Além disso, o usuário pode limpar o conteúdo da pasta de armazenamento compartilhado.
• Você não pode usar esse recurso para compartilhar dados entre aplicativos de diferentes editores.
• Você não pode usar esse recurso para compartilhar dados entre diferentes usuários.
• A pasta de armazenamento compartilhado não tem gerenciamento de versão.

Para registrar um aplicativo para usar a pasta de armazenamento compartilhado do editor

Insira XML manualmente semelhante ao exemplo a seguir no manifesto do aplicativo para registrar subpastas. Você não precisa criar essas subpastas. Eles são provisionados automaticamente para você.

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

Para acessar dados na pasta de armazenamento compartilhado do editor

Chame o método GetPublisherCacheFolder para obter uma das subpastas registradas da pasta de armazenamento compartilhado.

Em seguida, use as propriedades e os métodos da classe StorageFolder para ler e gravar arquivos e subpastas na pasta compartilhada.

O acesso à pasta de armazenamento compartilhado tem os seguintes requisitos e restrições.

• Não há nenhuma subpasta padrão. Você precisa especificar uma subpasta ao chamar o método GetPublisherCacheFolder.
• Você só pode acessar subpastas registradas no manifesto do aplicativo.
• Você não pode acessar a raiz da pasta de armazenamento compartilhado.

Para limpo os dados na pasta de armazenamento compartilhado do editor

Chame o método ClearPublisherCacheFolderAsync para limpar os arquivos e subpastas da subpasta especificada da pasta de armazenamento compartilhado para o editor do aplicativo atual.

A pasta de armazenamento compartilhado é limpa automaticamente quando o último aplicativo do publicador é desinstalado.

Os dados salvos na pasta de armazenamento compartilhado não estão vinculados ao aplicativo que os salvou. Quando você desinstala o aplicativo que salvou os dados, os dados permanecem na pasta de armazenamento compartilhado até que o último aplicativo do mesmo editor seja desinstalado.

Confira também

• ClearPublisherCacheFolderAsync(String)