Manipulação de arquivos, do início ao fim

Você pode acessar arquivos em um local, como uma pasta, uma biblioteca, um dispositivo ou um local da rede, com apenas uma única linha de código — uma chamada para a função StorageFolder.getFilesAsync. Veja Acessando arquivos de forma programática para instruções passo a passo que ilustram como realizar tarefas como enumerar arquivos e pastas de nível superior de um local especificado e consultar arquivos em um local.

Essas etapas mostram como enumerar arquivos em um local específico:

1. Obtenha um objeto StorageFolder para o local que deseja. Por exemplo, você pode fazer isso ao referenciar uma das propriedades KnownFolders estáticas, como KnowFolders.picturesLibrary.
2. Chame a função StorageFolder do objeto StorageFolder.getFilesAsync retornado. O exemplo auxiliar desse tópico chama esse método sem qualquer parâmetro, indicando se todos os arquivos devem ser retornados. Para ver exemplos de chamada StorageFolder.getFilesAsync com uma consulta, consulte Início rápido: acessando arquivos de forma programática.
3. Quando a função StorageFolder.getFilesAsync estiver concluída, você pode usar um loop forEach para iterar em cada arquivo retornado.

Esse exemplo de código enumera todos os arquivos em Imagens.

// Get a StorageFolder object representing Pictures.
var library = Windows.Storage.KnownFolders.picturesLibrary;

// Get all files from the StorageFolder object.
library.getFilesAsync().then(function (files) {
    // For each file found ...
    files.forEach(function (file) {
        // ... perform your processing.
        });
    });
}

Essa captura de tela do exemplo auxiliar mostra um exemplo de enumeração dos arquivos em Imagens.

Encontre no exemplo: o exemplo inclui uma página intitulada FileAccessBasics, que inclui os exemplos apresentados nesta seção. O código JavaScript e HTML relevante está centralizado nos arquivos FileAccessBasicsPage.js (função OnEnumPicturesClick) e FileAccessBasicsPage.html.

Guia de início rápido: lendo e gravando um arquivo

Um aplicativo da Windows Store lê e grava arquivos por meio da classe FileIO. Veja Guia de início rápido: lendo e gravando um arquivo para exemplos de código que mostram como ler e gravar vários tipos de dados usando as classes FileIO e StorageFile.

Gravando texto em um arquivo

1. Para gravar em um arquivo, você primeiro precisa adquirir um objeto StorageFile para passar para uma das funções FileIO para gravação de dados. Na amostra de acompanhamento, isso é feito ao criar um arquivo através da função StorageFolder.createFileAsync.
2. Depois que tiver um objeto StorageFile, você pode gravar texto no arquivo subjacente através de uma das funções FileIO.writeTextAsync sobrecarregadas.

// Create the sample file; replacing it if it already exists.
var lib = Windows.Storage.KnownFolders.picturesLibrary;
lib.createFileAsync("FileHandlingJs.txt", 
    Windows.Storage.CreationCollisionOption.replaceExisting)
.then(function (file) {
    if (file) {
        // Format a string based on the current data/time.
        var now = new Date();
        var sampleFileContents = 
            [[now.getMonth() + 1, now.getDate(), now.getFullYear()].join("/"),
            [now.getHours(), AddZero(now.getMinutes())].join(":"),
            now.getHours() >= 12 ? "PM" : "AM"].join(" ");

        // Write the text to the sample file.
        Windows.Storage.FileIO.writeTextAsync(file, sampleFileContents)
        .then(function () {
            // File's contents have been written at this point.
        }, 
        function (error) {
            // Handle error.
        });
    }
});

Lendo texto de um arquivo

1. Para ler o conteúdo de um arquivo, você primeiro precisa adquirir um objeto StorageFile para passar para uma das funções FileIO para leitura de dados. Na amostra de acompanhamento, isso é feito ao chamar a função StorageFolder.getFileAsync.
2. Após criar um objeto StorageFile, você pode ler o texto no arquivo subjacente através de uma das funções FileIO.readTextAsync sobrecarregadas.

// Open sample file.
Windows.Storage.KnownFolders.picturesLibrary.getFileAsync("FileHandlingJs.txt")
.then(function (file) {
    // If file found ...
    if (file) {
        // Read file's contents.
        Windows.Storage.FileIO.readTextAsync(file).then(function (contents) {
            // Process file contents as needed.
        });
    }
}, function (error) {
    // Handle error.
});

Essa captura de tela mostra um exemplo da execução do exemplo e da gravação no arquivo de exemplo.

Encontre no exemplo: o exemplo inclui uma página intitulada FileAccessBasics, que inclui os exemplos apresentados nesta seção. O código JavaScript e HTML relevante está centralizado nos arquivos FileAccessBasicsPage.js (funções OnWriteTextToFileClick e OnReadTextFromFileClick) e FileAccessBasicsPage.html.

Guia de início rápido: acessando arquivos com seletores de arquivos

Seletores — de arquivos e de pastas — são usados para exibir uma lista de arquivos/pastas, da qual o usuário pode selecionar um ou mais itens para processamento adicional. Os seletores podem ser configurados de forma programática para procurar arquivos e pastas que correspondem a um filtro especificado (como arquivos com extensões específicas), iniciar em uma pasta determinada, exibir um modo de exibição específico (lista ou miniatura) e muito mais.

Os procedimentos a seguir mostram como configurar os vários seletores para seleção de um único arquivo, vários arquivos e uma única pasta.

Configurando um seletor de arquivo de seleção de arquivo único

1. Instancie um objeto FileOpenPicker.
2. Defina o FileOpenPicker do objeto viewMode, suggestedStartLocation e as propriedades de fileTypeFilter conforme necessário.
3. Chame a função FileOpenPicker.pickSingleFileAsync. Quando a função FileOpenPicker.pickSingleFileAsync estiver concluída, o aplicativo possui acesso de leitura/gravação ao arquivo selecionado.

// Instantiate a FileOpenPicker object.
var openPicker = new Windows.Storage.Pickers.FileOpenPicker();

// Set the FileOpenPicker object's key properties.
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;

openPicker.suggestedStartLocation = 
    Windows.Storage.Pickers.PickerLocationId.picturesLibrary;

openPicker.fileTypeFilter.replaceAll([".jpg", ".jpeg", ".png" ]);

// Display the FileOpenPicker for single file selection.
openPicker.pickSingleFileAsync().then(function (file) {
    // If the user selected a file ...
    if (file) {
        // ... process file as needed.
    }
    else {
        // User canceled the operation.
    }
});

Configurando um seletor de arquivo de seleção de vários arquivos

1. Instancie um objeto FileOpenPicker.
2. Defina o FileOpenPicker do objeto FileOpenPicker.viewMode, FileOpenPicker.suggestedStartLocation e as propriedades de FileOpenPicker.FileTypeFilter conforme necessário.
3. Chame a função FileOpenPicker.pickMultipleFileAsync. Quando a função FileOpenPicker.pickMultipleFileAsync estiver concluída, o aplicativo possui acesso de leitura/gravação aos arquivos selecionados. Os arquivos selecionados são representados por uma matriz de objetos StorageFile. A propriedade sizes da matriz indica quantos arquivos foram selecionados, de forma que você pode usar um loop for com uma notação de matriz padrão para acessar cada objeto StorageFile.

// Instantiate a FileOpenPicker object.
var openPicker = new Windows.Storage.Pickers.FileOpenPicker();

// Set the FileOpenPicker object's key properties.
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;

openPicker.suggestedStartLocation = 
    Windows.Storage.Pickers.PickerLocationId.picturesLibrary;

openPicker.fileTypeFilter.replaceAll([".jpg", ".jpeg", ".png"]);

// Display the FileOpenPicker for multiple-file selection.
openPicker.pickMultipleFilesAsync().then(function (files) {
    // If the user selected at least one file ...
    if (files.size > 0) {
        for (var i = 0; i < files.size; i++) {
            // ... process each file - For example, files[i]
        }
    }
    else {
        // User canceled the operation.
    }
});

Configurando um seletor de pasta

1. Instancie um objeto FolderPicker.
2. Defina o FolderPicker do objeto FolderPicker.viewMode, FolderPicker.suggestedStartLocation e as propriedades de FolderPicker.fileTypeFilter conforme necessário.
3. Chame a função FileOpenPicker.pickSingleFileAsync. Quando a função FolderPicker.pickSingleFolderAsync estiver concluída, o aplicativo possui acesso de leitura/gravação às pastas selecionadas, incluindo subpastas.

// Instantiate a FolderPicker object.
var folderPicker = new Windows.Storage.Pickers.FolderPicker();

// Set the FileOpenPicker object's key properties.
folderPicker.suggestedStartLocation = 
    Windows.Storage.Pickers.PickerLocationId.desktop;
folderPicker.fileTypeFilter.replaceAll([".docx", ".xlsx", ".pptx"]);

// Display the FolderPicker for folder selection.
folderPicker.pickSingleFolderAsync().then(function (folder) {
    // If the user selected a folder ...
    if (folder) {
        // ... get the folder object.
        Windows.Storage.AccessCache.StorageApplicationPermissions.
        futureAccessList.addOrReplace("PickedFolderToken", folder);
        // Process folder as needed.
    }
    else {
        // User canceled operation.
    }
});

Essa captura de tela mostra os resultados de execução do exemplo e seleção dos dois arquivos (sample1.png e sample2.png).

Encontre no exemplo: o exemplo inclui uma página intitulada Seletores de arquivo e pasta, que demonstra as tarefas descritas nesta seção. O código JavaScript e HTML para esse exemplo está nos arquivos FilePickerPage.js e FilePickerPage.html, respectivamente.

Guia de início rápido: determinando a disponibilidade de arquivos OneDrive

O Windows 8.1 permite que os usuários marquem arquivos do OneDrive como somente online. Quando o usuário se desconecta do OneDrive, esses arquivos não ficam disponíveis. Para ajudar a determinar de forma programática a disponibilidade de um arquivo, há uma nova propriedade chamada StorageFile.isAvailable.

Essas etapas mostram como determinar a disponibilidade dos arquivos usando a propriedade StorageFile.isAvailable.

1. Obtenha um objeto StorageFolder para o local que deseja. Por exemplo, você pode fazer isso ao referenciar uma das propriedades KnownFolders estáticas, como KnowFolders.picturesLibrary.
2. Chame a função StorageFolder do objeto StorageFolder.getFilesAsync retornado. O exemplo auxiliar desse tópico chama esse método sem qualquer parâmetro, indicando se todos os arquivos devem ser retornados. Para ver exemplos de chamada StorageFolder.getFilesAsync com uma consulta, consulte Início rápido: acessando arquivos de forma programática.
3. Quando a função StorageFolder.getFilesAsync estiver concluída, você pode usar um loop forEach para iterar em cada arquivo retornado.

// Get a StorageFolder object representing Pictures.
var library = Windows.Storage.KnownFolders.picturesLibrary;

// Initialize string that will contain the file name, provider name, 
// and availability for each file.
var outString = "";

// Get all files from the StorageFolder object.
library.getFilesAsync().then(function (files) {
    // For each file found ...
    files.forEach(function (file) {
        // Retrieve the file's name, provider name, and availability.
        outString += file.name 
                  + " (on " 
                  + file.provider.displayName 
                  + ") is " 
                  + (file.isAvailable ? "available" : "not available") + "\n";
    });
});

Essa captura de tela mostra exemplo de resultados da verificação dos arquivos em Imagens para fins de disponibilidade.

Encontre no exemplo: o exemplo inclui uma página intitulada "Arquivos do OneDrive", que tem um botão que enumera todos os arquivos na biblioteca de Imagens da máquina local. Cada nome de arquivo é exibido junto com o provedor desse arquivo (por exemplo, Este Computador ou OneDrive) e se o arquivo está ou não disponível atualmente. O código JavaScript e o HTML para esse exemplo estão nos arquivos OneDriveFilesPage.js e OneDriveFilesPage.html, respectivamente.

Usando o Kit de Certificação de Aplicativos Windows

Recomendado. Executar o Kit de Certificação de Aplicativos para Windows ajuda a garantir que seu aplicativo cumpra os requisitos da Windows Store. Recomendamos que você execute-o sempre que adicionar a funcionalidade principal em seu aplicativo.