DownloadOperation Classe

Définition

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

Héritage

Object Platform::Object IInspectable DownloadOperation

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IBackgroundTransferOperation IBackgroundTransferOperationPriority

Configuration requise pour Windows

Exemples

Les exemples d’applications qui utilisent cette classe incluent l’exemple de transfert en arrière-plan.

L’exemple suivant montre comment configurer et commencer une opération de téléchargement de base.

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

Remarques

Au démarrage suivant après l’arrêt de l’application, votre application doit énumérer toutes les instances DownloadOperation existantes à l’aide de GetCurrentDownloadsAsync. Lorsqu’une application UWP utilisant le transfert en arrière-plan est arrêtée, les téléchargements incomplets persistent en arrière-plan. Si votre application est redémarrée après l’arrêt et que ces opérations incomplètes ne sont pas énumérées et réinitatives dans la session active, elles seront obsolètes et continuent d’occuper les ressources de l’appareil.

Le transfert en arrière-plan ne prend pas en charge les téléchargements simultanés du même URI. Ainsi, une application peut télécharger http://example.com/myfile.wmv une seule fois ou la télécharger à nouveau une fois le téléchargement précédent terminé. Une application ne doit pas démarrer simultanément deux téléchargements du même URI , car cela peut entraîner des fichiers tronqués.

Considérations relatives au délai d’expiration

1. Lors de l’établissement d’une nouvelle connexion pour un téléchargement via TCP/SSL, la tentative de connexion est abandonnée si elle n’est pas établie dans les cinq minutes.
2. Une fois la connexion établie, un message de requête HTTP qui n’a pas reçu de réponse dans les deux minutes est abandonné. En supposant qu’il existe une connectivité Internet, le transfert en arrière-plan effectue une nouvelle tentative de téléchargement jusqu’à trois fois. Si la connectivité Internet n’est pas détectée, d’autres tentatives ne sont pas effectuées tant qu’elle ne l’est pas.

Conseils de débogage

L’arrêt d’une session de débogage dans Microsoft Visual Studio est comparable à la fermeture de votre application ; les téléchargements sont suspendus et les téléchargements POST sont terminés. Même pendant le débogage, votre application doit énumérer, puis suspendre, reprendre, redémarrer ou annuler les téléchargements persistants.

Toutefois, si les mises à jour du projet Microsoft Visual Studio, telles que les modifications apportées au manifeste de l’application, nécessitent que l’application soit désinstallée et redéployée pour le débogage, GetCurrentDownloadsAsync ne peut pas énumérer les opérations persistantes créées à l’aide du déploiement d’application précédent.

Historique des versions

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Démarrage rapide : Télécharger un fichier
• Exemple de transfert en arrière-plan
• Exemple de transfert en arrière-plan (Windows 8.x)