[This documentation is preliminary and is subject to change.]
Enables advanced download and upload transfer capabilities within a Metro style app. For an overview of Background Transfer capabilities, see Transferring data in the background.
Note Background Transfer is primarily designed for long-term transfer operations for resources like video, music, and large images. For short-term operations involving transfers of smaller resources (i.e. a couple KB), the use of provided HTTP APIs (XHR in JavaScript, HttpClient in .NET, and IXHR2 in C++) is recommended.
Members
The Windows.Networking.BackgroundTransfer namespace has these types of members:
Classes
The Windows.Networking.BackgroundTransfer namespace has these classes.
| Class | Description |
|---|---|
| BackgroundDownloader | Used to configure downloads prior to the actual creation of the download operation using CreateDownload. |
| BackgroundTransferContentPart | Represents a content part of a multi-part transfer request. Each BackgroundTransferContentPart object can represent either a single string of text content or a single file payload, but not both. |
| BackgroundTransferError | Used to provide errors encountered during a transfer operation. |
| BackgroundUploader | Used to configure upload prior to the actual creation of the upload operation using CreateUpload. |
| DownloadOperation | Performs an asynchronous download operation. The Background Transfer sample demonstrates this functionality. |
| ResponseInformation | Represents data that is returned by a server response. |
| UploadOperation | Performs an asynchronous upload operation. |
Enumerations
The Windows.Networking.BackgroundTransfer namespace has these enumerations.
| Enumeration | Description |
|---|---|
| BackgroundTransferCostPolicy | Defines values used to specify whether transfers can occur on costed networks. |
| BackgroundTransferStatus | Defines transfer operation status values. |
Interfaces
The Windows.Networking.BackgroundTransfer namespace implements these interfaces.
| Interface | Description |
|---|---|
| IBackgroundTransferBase | Represents a background transfer operation. |
| IBackgroundTransferContentPartFactory | Creates a BackgroundTransferContentPart object. |
| IBackgroundTransferOperation | Represents a background transfer operation. |
Structures
The Windows.Networking.BackgroundTransfer namespace has these structures.
| Structure | Description |
|---|---|
| BackgroundDownloadProgress | Contains status information about the download operation. |
| BackgroundUploadProgress | Contains status information about the upload operation. |
Requirements
|
Minimum supported client | Windows 8 Release Preview |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
Build date: 5/22/2012
