Partilhar via

Guia de início rápido: determinando a disponibilidade de arquivos do Microsoft OneDrive (HTML)

  • Artigo

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Determine se um arquivo OneDrive está disponível usando a propriedade StorageFile.isAvailable.

Pré-requisitos

Muitos dos métodos usados para interagir com pastas e arquivos são assíncronos. Você pode aprender como escrever aplicativos assíncronos em Programação assíncrona em JavaScript.

Usando a propriedade StorageFile.isAvailable

No Windows 8.1, os usuários podem marcar os arquivos OneDrive como disponível offline (padrão) ou somente online. Com essa funcionalidade, os usuários podem transferir arquivos grandes (como fotos e vídeos) para o OneDrive, marcá-los como somente online e economizar espaço em disco (visto que localmente é mantido um arquivo contendo apenas metadados sobre o arquivo remoto).

Uma nova propriedade, StorageFile.isAvailable, é usada para determinar se um arquivo está disponível no momento. A tabela a seguir mostra o valor da propriedade StorageFile.isAvailable em diversos cenários.

Tipo de arquivo Online Rede limitada Offline
Arquivo local True True True
Arquivo OneDrive marcado como disponível offline True True True
Arquivo OneDrive marcado como somente online True Baseado nas configurações do usuário False
Arquivo de rede True Baseado nas configurações do usuário False

 

As etapas a seguir ilustram como determinar se um arquivo está disponível no momento.

  1. Defina os recursos de acesso à biblioteca adequada. Dependendo da biblioteca que está sendo enumerada, você precisa definir a capacidade para acessar essa biblioteca. Para saber mais sobre isso e sobre como definir outros recursos no nível do arquivo para projetos do Microsoft Visual Studio, veja Acesso e permissões a arquivos para aplicativos da Windows Store
  2. Adquira um objeto StorageFolder que representa a pasta cujos arquivos serão enumerados. Isso é feito referindo-se a uma das propriedades estáticas do Windows.Storage.KnownFolders, como Windows.Storage.KnownFolders.picturesLibrary.
  3. Chame o método StorageFolder.getFilesAsync para recuperar todos os arquivos na pasta associada.
  4. Itere sobre a coleção de arquivos retornados, referendo-se à propriedade isAvailable para cada objeto do StorageFile.

O método a seguir enumera a Biblioteca de imagens e exibe o nome, o nome do provedor e a disponibilidade para cada arquivo.

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;
    });
}

Resumo

Neste guia de início rápido, você aprendeu sobre como determinar programaticamente a disponibilidade de um arquivo do OpenDrive.