ApplicationData.GetPublisherCacheFolder(String) Methode

Definition

Namespace:

Windows.Storage

Ruft den angegebenen Unterordner des freigegebenen Speicherordners für den Herausgeber der aktuellen App ab.

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

Parameter

folderName

String

Platform::String

winrt::hstring

Der Unterordner, der aus dem freigegebenen Speicherordner für den Herausgeber der aktuellen App abgerufen werden soll.

Gibt zurück

StorageFolder

Der angegebene Unterordner.

Hinweise

Das starke Sicherheitsmodell von Windows-Runtime-App verhindert in der Regel, dass Apps Daten untereinander freigeben. Es kann jedoch für Apps desselben Herausgebers hilfreich sein, Dateien und Einstellungen auf Benutzerbasis gemeinsam zu nutzen. Als App-Herausgeber können Sie dem App-Manifest Erweiterungen hinzufügen und so Ihre App registrieren, damit sie mit anderen von Ihnen veröffentlichten Apps einen gemeinsamen Speicherordner nutzt.

Hier finden Sie einige Beispiele für die Verwendung dieses freigegebenen Speicherordners, wenn Sie mehrere Apps veröffentlichen.

• Freigeben von Dateien. Wenn beispielsweise mehrere Apps dieselben Bilder oder die gleichen benutzerdefinierten Schriftarten verwenden, können Sie diese Dateien im freigegebenen Speicherordner speichern.
• Geben Sie die Einstellungen des Benutzers in einer benutzerdefinierten Einstellungsdatei frei. Wenn beispielsweise mehrere Apps Temperaturen verwenden, können Sie eine Kopie der Benutzerpräferenz für Celsius oder Fahrenheit in einer benutzerdefinierten Einstellungsdatei im freigegebenen Speicherordner speichern. Es wird jedoch empfohlen, die Einstellungen des Benutzers auch mit jeder App oder an einem anderen master Speicherort zu speichern, da der Benutzer den Inhalt des freigegebenen Speicherordners löschen kann. Der freigegebene Speicherordner für den App-Herausgeber wird automatisch bereitgestellt, wenn der Benutzer die erste App vom Herausgeber installiert.

Für den freigegebenen Speicherordner gelten die folgenden Anforderungen und Einschränkungen.

• Daten im freigegebenen Speicherordner werden nicht gesichert oder verschoben. Außerdem kann der Benutzer den Inhalt des freigegebenen Speicherordners löschen.
• Sie können dieses Feature nicht verwenden, um Daten für Apps von verschiedenen Herausgebern gemeinsam zu nutzen.
• Sie können dieses Feature nicht verwenden, um Daten für verschiedene Benutzer gemeinsam zu nutzen.
• Der freigegebene Speicherordner verfügt nicht über eine Versionsverwaltung.

So registrieren Sie eine App für die Verwendung des freigegebenen Speicherordners des Herausgebers

Geben Sie XML ähnlich dem folgenden Beispiel manuell in das App-Manifest ein, um Unterordner zu registrieren. Sie müssen diese Unterordner nicht erstellen. Sie werden automatisch für Sie bereitgestellt.

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

So greifen Sie auf Daten im freigegebenen Speicherordner des Herausgebers zu

Rufen Sie die GetPublisherCacheFolder-Methode auf, um einen der registrierten Unterordner aus dem freigegebenen Speicherordner abzurufen.

Verwenden Sie dann die Eigenschaften und Methoden der StorageFolder-Klasse , um Dateien und Unterordner im freigegebenen Ordner zu lesen und zu schreiben.

Für den Zugriff auf den freigegebenen Speicherordner gelten die folgenden Anforderungen und Einschränkungen.

• Es gibt keinen Standardunterordner. Sie müssen einen Unterordner angeben, wenn Sie die GetPublisherCacheFolder-Methode aufrufen.
• Sie können nur auf Unterordner zugreifen, die im App-Manifest registriert sind.
• Sie können nicht auf den Stamm des freigegebenen Speicherordners zugreifen.

So sauber Sie die Daten im freigegebenen Speicherordner des Herausgebers auf

Rufen Sie die ClearPublisherCacheFolderAsync-Methode auf, um die Dateien und Unterordner aus dem angegebenen Unterordner des freigegebenen Speicherordners für den Herausgeber der aktuellen App zu löschen.

Der freigegebene Speicherordner wird automatisch bereinigt, wenn die letzte App des Herausgebers deinstalliert wird.

Daten, die im freigegebenen Speicherordner gespeichert sind, sind nicht mit der App verknüpft, die sie gespeichert hat. Wenn Sie die App deinstallieren, die die Daten gespeichert hat, verbleiben die Daten im freigegebenen Speicherordner, bis die letzte App desselben Herausgebers deinstalliert wird.

Weitere Informationen

• ClearPublisherCacheFolderAsync(String)