DownloadOperation Classe

Definição

public ref class DownloadOperation sealed : IBackgroundTransferOperationPriority

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DownloadOperation final : IBackgroundTransferOperationPriority

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DownloadOperation : IBackgroundTransferOperationPriority

Public NotInheritable Class DownloadOperation
Implements IBackgroundTransferOperationPriority

Herança

Object Platform::Object IInspectable DownloadOperation

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IBackgroundTransferOperation IBackgroundTransferOperationPriority

Requisitos do Windows

Exemplos

Os aplicativos de exemplo que usam essa classe incluem o exemplo de transferência em segundo plano.

O exemplo a seguir demonstra como configurar e iniciar uma operação básica de download.

using Windows.Foundation;
using Windows.Networking.BackgroundTransfer;
using Windows.Storage;

private async void StartDownload_Click(object sender, RoutedEventArgs e)
{
    try
    {
        Uri source = new Uri(serverAddressField.Text.Trim());
        string destination = fileNameField.Text.Trim();

        StorageFile destinationFile = await KnownFolders.PicturesLibrary.CreateFileAsync(
            destination, CreationCollisionOption.GenerateUniqueName);

        BackgroundDownloader downloader = new BackgroundDownloader();
        DownloadOperation download = downloader.CreateDownload(source, destinationFile);

        // Attach progress and completion handlers.
        HandleDownloadAsync(download, true);
    }
    catch (Exception ex)
    {
        LogException("Download Error", ex);
    }
}

Comentários

Na próxima inicialização após o encerramento do aplicativo, seu aplicativo deve enumerar todas as instâncias DownloadOperation existentes usando GetCurrentDownloadsAsync. Quando um aplicativo UWP que usa a Transferência em Segundo Plano é encerrado, os downloads incompletos persistem em segundo plano. Se o aplicativo for reiniciado após o encerramento e essas operações incompletas não forem enumeradas e introduzidas novamente na sessão atual, elas ficarão obsoletas e continuarão ocupando os recursos do dispositivo.

A transferência em segundo plano não dá suporte a downloads simultâneos do mesmo URI. Portanto, um aplicativo pode baixar http://example.com/myfile.wmv uma vez ou baixá-lo novamente após a conclusão de um download anterior. Um aplicativo não deve iniciar dois downloads do mesmo Uri simultaneamente, pois isso pode resultar em arquivos truncados.

Considerações sobre tempo limite

1. Ao estabelecer uma nova conexão para um download por TCP/SSL, a tentativa de conexão será anulada se não for estabelecida dentro de cinco minutos.
2. Depois que a conexão for estabelecida, uma mensagem de solicitação HTTP que não recebeu uma resposta dentro de dois minutos será anulada. Supondo que haja conectividade com a Internet, a Transferência em Segundo Plano repetirá um download até três vezes. Caso a conectividade com a Internet não seja detectada, não serão feitas tentativas adicionais até que ela seja.

Diretrizes de depuração

Interromper uma sessão de depuração no Microsoft Visual Studio é comparável ao fechamento do aplicativo; os downloads são pausados e os uploads POST são encerrados. Mesmo durante a depuração, seu aplicativo deve enumerar e, em seguida, pausar, retomar, reiniciar ou cancelar quaisquer downloads persistentes.

No entanto, se o projeto do Microsoft Visual Studio for atualizado, como alterações no manifesto do aplicativo, exigir que o aplicativo seja desinstalado e implantado novamente para depuração, GetCurrentDownloadsAsync não poderá enumerar as operações persistentes criadas usando a implantação anterior do aplicativo.

Histórico de versão

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Início Rápido: Baixar um arquivo
• Exemplo de transferência em segundo plano
• Exemplo de transferência em segundo plano (Windows 8.x)