DownloadOperation.AttachAsync Méthode

Définition

Espace de noms:

Windows.Networking.BackgroundTransfer

Retourne une opération asynchrone qui peut être utilisée pour surveiller la progression et l’achèvement du téléchargement joint. L’appel de cette méthode permet à une application d’attacher des opérations de téléchargement qui ont été démarrées dans un instance d’application précédent.

public:
 virtual IAsyncOperationWithProgress<DownloadOperation ^, DownloadOperation ^> ^ AttachAsync() = AttachAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DownloadOperation, DownloadOperation const&> AttachAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DownloadOperation,DownloadOperation> AttachAsync();

function attachAsync()

Public Function AttachAsync () As IAsyncOperationWithProgress(Of DownloadOperation, DownloadOperation)

Retours

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Opération de téléchargement avec rappel.

Attributs

RemoteAsyncAttribute

Exemples

function AttachDownload (loadedDownload) {
    try {
        download = loadedDownload;
        promise = download.attachAsync().then(complete, error, progress);
    } catch (err) {
        displayException(err);
    }
};

Remarques

Exceptions

COMException

Levée lorsqu’un HRESULT spécifique à une fonctionnalité est retourné à partir d’un appel de méthode.

Il s’agit de l’exception la plus courante levée par les méthodes réseau. Une application doit utiliser le HRESULT de l’exception pour déterminer la cause de l’erreur.

AccessDeniedException

Levée lorsque l'accès est refusé à une ressource ou à une fonctionnalité. Cette exception se produit lorsqu’une application n’a pas les fonctionnalités réseau requises définies dans le manifeste de l’application pour l’opération réseau demandée.

InvalidArgumentException

Levée lorsque l'un des arguments fournis à une méthode n'est pas valide.

Si l’entrée fournie par l’utilisateur a provoqué cette exception, une application peut informer l’utilisateur et demander une nouvelle entrée.

ObjectDisposedException

Levée lorsqu'une opération est exécutée sur un objet supprimé.

OutOfMemoryException

Levée lorsque la mémoire disponible est insuffisante pour terminer l’opération.

Bien que cette méthode puisse être appelée à partir de plusieurs instances d’application, les développeurs ne doivent pas attacher de rappels à partir de l’application principale instance dans une tâche en arrière-plan. Cela entraîne le blocage deBackgroundTransferHost.exe .