ApplicationData.GetPublisherCacheFolder(String) 方法

定義

命名空間:

Windows.Storage

取得目前應用程式發行者之共用儲存資料夾的指定子資料夾。

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

參數

folderName

String

Platform::String

winrt::hstring

要從目前應用程式發行者的共用儲存資料夾取得的子資料夾。

傳回

StorageFolder

指定的子資料夾。

備註

Windows 執行階段應用程式的強式安全性模型通常可防止應用程式彼此共用資料。 不過，對於來自相同發行者的應用程式，以每個使用者為基礎共用檔案和設定，這非常有用。 身為應用程式發佈者，您可以藉由在應用程式資訊清單中新增擴充功能，以登錄您的應用程式，使其與您發佈的其他應用程式共用存放裝置資料夾。

以下是當您發佈多個應用程式時，如何使用此共用儲存資料夾的一些範例。

• 共用檔案。 例如，如果多個應用程式使用相同的影像或相同的自訂字型，您可以將這些檔案儲存在共用儲存資料夾中。
• 在自訂設定檔中共用使用者的設定。 例如，如果多個應用程式使用溫度，您可以將使用者的喜好設定複本儲存在共用儲存資料夾中的自訂設定檔中，以攝氏或 Fahrenheit。 不過，建議您將使用者的設定與每個應用程式或另一個主要位置儲存在一起，因為使用者可以清除共用儲存資料夾的內容。 當使用者從發行者安裝第一個應用程式時，會自動布建應用程式發行者的共用儲存資料夾。

共用儲存資料夾具有下列需求和限制。

• 共用儲存資料夾中的資料不會備份或漫遊。 此外，使用者可以清除共用儲存資料夾的內容。
• 您無法使用此功能在來自不同發行者的應用程式之間共用資料。
• 您無法使用此功能在不同的使用者之間共用資料。
• 共用儲存資料夾沒有版本管理。

若要註冊應用程式以使用發行者的共用儲存資料夾

在應用程式資訊清單中手動輸入類似下列範例的 XML，以註冊子資料夾。 您不需要建立這些子資料夾。 系統會自動為您布建它們。

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

存取發行者共用儲存資料夾中的資料

呼叫 GetPublisherCacheFolder 方法，從共用儲存資料夾取得其中一個已註冊的子資料夾。

然後使用 StorageFolder 類別的屬性和方法，讀取和寫入共用資料夾中的檔案和子資料夾。

共用儲存資料夾的存取權具有下列需求和限制。

• 沒有預設子資料夾。 呼叫 GetPublisherCacheFolder 方法時，您必須指定子資料夾。
• 您只能存取應用程式資訊清單中註冊的子資料夾。
• 您無法存取共用儲存資料夾的根目錄。

清除發行者共用資料夾中的資料

呼叫 ClearPublisherCacheFolderAsync 方法，從目前應用程式發行者之共用儲存資料夾的指定子資料夾中清除檔案和子資料夾。

當發行者的最後一個應用程式卸載時，會自動清除共用儲存資料夾。

儲存在共用儲存資料夾中的資料不會連結到儲存它的應用程式。 當您卸載儲存資料的應用程式時，資料會保留在共用儲存資料夾中，直到卸載相同發行者的最後一個應用程式為止。

另請參閱

• ClearPublisherCacheFolderAsync(String)