Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 Uri UploadLocation { get; set; }

Property Value

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

Caution noteCaution:

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.

InvalidOperationException

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

NotSupportedException

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

ArgumentException

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.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Windows Phone

Show: