DownloadOperation.RequestedUri Property

Reference

Definition

Namespace:: Windows.Networking.BackgroundTransfer

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Gets the URI from which to download the file.

public:
 property Uri ^ RequestedUri { Uri ^ get(); };

public:
 property Uri ^ RequestedUri { Uri ^ get(); void set(Uri ^ value); };

Uri RequestedUri();

Uri RequestedUri();

void RequestedUri(Uri value);

public System.Uri RequestedUri { get; }

public System.Uri RequestedUri { get; set; }

var uri = downloadOperation.requestedUri;

var uri = downloadOperation.requestedUri;
downloadOperation.requestedUri = uri;

Public ReadOnly Property RequestedUri As Uri

Public Property RequestedUri As Uri

Property Value

Uri Uri

The URI to download from.

Implements

RequestedUri

Remarks

The URI can be updated in for transfers that have hit a recoverable error (PausedRecoverableWebErrorStatus), or that have explicitly paused by the app (PausedByApplication). Once the URI has been updated, the app must call DownloadOperation.Resume to initiate a retry.

Due to OS limitations, downloads that don't opt into random access mode will always restart from scratch whenever their URL is updated. To opt into random access mode, set DownloadOperation.IsRandomAccessRequired to true. Transfers configured that way have full support for resumable URL updates. If the timestamp or file size of the updated URL is different from that of the previous URL, the download will restart from scratch. Otherwise, the transfer will resume from the same position using the new URL.

Applies to