Enables advanced download and upload transfer capabilities within an app. For an overview of Background Transfer capabilities, see Transferring data in the background. Download the Background Transfer sample for examples in JavaScript, C#, and C++.
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 defines 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. |
Remarks
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
Build date: 12/4/2012
