Schnellstart: Ermitteln der Verfügbarkeit von Microsoft OneDrive-Dateien (HTML)

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

Ermitteln Sie mithilfe der StorageFile.isAvailable-Eigenschaft, ob eine OneDrive-Datei verfügbar ist.

Voraussetzungen

Viele Methoden, die zum Interagieren mit Ordnern und Dateien verwendet werden, sind asynchron. Unter Asynchrone Programmierung in JavaScript erfahren Sie, wie Sie asynchrone Apps erstellen.

Verwenden der StorageFile.isAvailable-Eigenschaft

In Windows 8.1 können Benutzer OneDrive-Dateien als "Offline verfügbar" (Standardeinstellung) oder "Nur online verfügbar" kennzeichnen. Diese Funktion bietet Benutzern die Möglichkeit, große Dateien (z. B. Bilder und Videos) in ihren OneDrive-Speicher zu verschieben, als nur online verfügbar zu kennzeichnen und so Speicherplatz auf der Festplatte zu sparen (lokal wird nur eine Datei mit Metadaten zur Remotedatei gespeichert).

Mit einer neuen Eigenschaft – StorageFile.isAvailable – wird ermittelt, ob eine Datei momentan verfügbar ist. Die folgende Tabelle zeigt den Wert der StorageFile.isAvailable-Eigenschaft in verschiedenen Szenarien.

Die folgenden Schritte zeigen, wie festgestellt wird, ob eine Datei momentan verfügbar ist.

1. Definieren Sie die entsprechenden Funktionen für den Zugriff auf die Bibliothek. Je nach aufgezählter Bibliothek müssen Sie die Funktion zum Zugreifen auf diese Bibliothek definieren. Weitere Informationen hierzu und zur Definition anderer Funktionen auf Dateiebene für Microsoft Visual Studio-Projekte finden Sie unter Dateizugriff und Berechtigungen für Windows Store-Apps.
2. Rufen Sie ein StorageFolder-Objekt ab, das den Ordner darstellt, dessen Dateien aufgelistet werden. Dazu verweisen Sie auf eine der statischen Windows.Storage.KnownFolders-Eigenschaften, z. B. Windows.Storage.KnownFolders.picturesLibrary.
3. Rufen Sie die StorageFolder.getFilesAsync-Methode auf, um alle Dateien im zugeordneten Ordner abzurufen.
4. Durchlaufen Sie die zurückgegebene Dateisammlung, und verweisen Sie dabei für jedes StorageFile-Objekt auf die isAvailable-Eigenschaft.

Die folgende Methode listet die Bildbibliothek auf und zeigt den Namen, den Anbieternamen sowie die Verfügbarkeit für jede Datei an.

function OnDisplayAvailabilityClick(mouseEvent) {
    var output = document.getElementById("Output");

    var library = Windows.Storage.KnownFolders.picturesLibrary;
    var outString = "";
    library.getFilesAsync().then(function (files) {
        files.forEach(function (file) {
            outString += file.name + " (on " + file.provider.displayName + ") is " + (file.isAvailable ? "available" : "not available") + "\n";
        });
        output.innerText = outString;
    });
}

Zusammenfassung

In dieser Schnellstartanleitung haben Sie erfahren, wie Sie programmgesteuert ermitteln, ob eine OneDrive-Datei verfügbar ist.