BackgroundTransferRequest.UploadLocation Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets or sets the location from which the requested file will be uploaded.

Namespace: Microsoft.Phone.BackgroundTransfer
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)


Public Property UploadLocation As Uri
public Uri UploadLocation { get; set; }

Property Value

Type: System..::.Uri
The location from which the requested file will be uploaded



To help isolate the files to which the background transfer service has access, all transfers must be uploaded from a file within the \shared\transfers directory in the application’s isolated storage. You may add additional directories under this directory, but attempting to set a URI that is outside of the transfer directory will throw an exception.

The maximum file size supported for uploads is over a cellular connection is 5 MB. Over Wi-Fi with battery power the maximum is 20 MB. Over Wi-Fi with external power, the maximum is 100MB.

This method may throw one of the following exceptions.


A transfer request’s properties cannot be modified after it has been submitted or disposed.


The path must point to a location within the \shared\transfers directory. Only relative URIs are supported. The path cannot be zero length.


The path must end with a file name.

The specified Uri must be of type UriKind.Relative. Absolute paths using the “isostore:” Uri schema are not supported.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1


Windows Phone

See Also


BackgroundTransferRequest Class

Microsoft.Phone.BackgroundTransfer Namespace