DownloadOperation.AttachAsync Methode

Referenz

Definition

Namespace:: Windows.Networking.BackgroundTransfer

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Gibt einen asynchronen Vorgang zurück, der verwendet werden kann, um den Fortschritt und den Abschluss des angefügten Downloads zu überwachen. Durch Aufrufen dieser Methode kann eine App Downloadvorgänge anfügen, die in einer vorherigen App instance gestartet wurden.

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)

Gibt zurück

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Downloadvorgang mit Rückruf.

Attribute: RemoteAsyncAttribute

Beispiele

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

Hinweise

Ausnahmen

COMException

Wird ausgelöst, wenn ein featurespezifisches HRESULT von einem Methodenaufruf zurückgegeben wird.

Dies ist die häufigste Ausnahme, die von Netzwerkmethoden ausgelöst wird. Eine App sollte das HRESULT aus der Ausnahme verwenden, um die Fehlerursache zu ermitteln.

AccessDeniedException

Wird ausgelöst, wenn der Zugriff auf eine Ressource oder eine Funktion verweigert wird. Diese Ausnahme tritt auf, wenn für eine App nicht die erforderlichen Netzwerkfunktionen im App-Manifest für den angeforderten Netzwerkvorgang festgelegt sind.

InvalidArgumentException

Wird ausgelöst, wenn eines der Argumente für eine Methode ungültig ist.

Wenn die vom Benutzer bereitgestellte Eingabe diese Ausnahme verursacht hat, kann eine App den Benutzer informieren und neue Eingaben anfordern.

ObjectDisposedException

Wird ausgelöst, wenn ein Vorgang für ein verworfenes Objekt ausgeführt wird.

OutOfMemoryException

Wird ausgelöst, wenn nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs verfügbar ist.

Diese Methode kann zwar von mehreren App-Instanzen aufgerufen werden, Entwickler sollten jedoch keine Rückrufe aus der primären App instance in einer Hintergrundaufgabe anfügen. Dies führt dazu , dassBackgroundTransferHost.exe hängen bleibt.

Gilt für:

Freigeben über