Поделиться через

DownloadOperation.AttachAsync Метод

  • Ссылка

Определение

Пространство имен:
Windows.Networking.BackgroundTransfer
Изменить

Возвращает асинхронную операцию, которую можно использовать для отслеживания хода выполнения и завершения вложенного скачивания. Вызов этого метода позволяет приложению присоединять операции скачивания, запущенные в предыдущем экземпляре приложения.

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)

Возвращаемое значение

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Операция скачивания с обратным вызовом.

Атрибуты
RemoteAsyncAttribute

Примеры

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

Комментарии

Исключения

COMException

Возникает при возврате HRESULT для конкретной функции из вызова метода.

Это наиболее распространенное исключение, вызываемое сетевыми методами. Приложение должно использовать HRESULT из исключения, чтобы определить причину ошибки.

AccessDeniedException

Возникает при запрете доступа к ресурсу или функции. Это исключение возникает, когда приложение не имеет необходимых сетевых возможностей, заданных в манифесте приложения для запрошенной сетевой операции.

InvalidArgumentException

Вызывается, если один из передаваемых методу аргументов является недопустимым.

Если входные данные, предоставленные пользователем, вызвали это исключение, приложение может сообщить пользователю и запросить новые входные данные.

ObjectDisposedException

Вызывается при выполнении операции над ликвидированным объектом.

OutOfMemoryException

Возникает, когда недостаточно памяти для завершения операции.

Хотя этот метод можно вызывать из нескольких экземпляров приложения, разработчикам не следует присоединять обратные вызовы из основного экземпляра приложения в фоновой задаче. Это приведет к зависаюBackgroundTransferHost.exe .

Применяется к