DownloadOperation.AttachAsync Metodo

Definizione

Spazio dei nomi:

Windows.Networking.BackgroundTransfer

Restituisce un'operazione asincrona che può essere utilizzata per monitorare lo stato di avanzamento e il completamento del download collegato. La chiamata a questo metodo consente a un'app di allegare le operazioni di download avviate in un'istanza precedente dell'app.

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)

Restituisce

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Operazione di download con callback.

Attributi

RemoteAsyncAttribute

Esempio

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

Commenti

Eccezioni

COMException

Generata quando viene restituito un HRESULT specifico della funzionalità da una chiamata al metodo.

Si tratta dell'eccezione più comune generata dai metodi di rete. Un'app deve usare HRESULT dall'eccezione per determinare la causa dell'errore.

AccessDeniedException

Generata quando viene negato l'accesso a una risorsa o a una funzionalità. Questa eccezione si verifica quando un'app non ha le funzionalità di rete necessarie impostate nel manifesto dell'app per l'operazione di rete richiesta.

InvalidArgumentException

Generata quando uno degli argomenti forniti a un metodo non è valido.

Se l'input fornito dall'utente ha causato questa eccezione, un'app potrebbe informare l'utente e richiedere un nuovo input.

ObjectDisposedException

Generata quando viene eseguita un'operazione su un oggetto eliminato.

OutOfMemoryException

Generata quando è disponibile memoria insufficiente per completare l'operazione.

Anche se questo metodo può essere chiamato da più istanze dell'app, gli sviluppatori non devono collegare i callback dall'istanza dell'app primaria in un'attività in background. In questo modo BackgroundTransferHost.exe blocco.