BackgroundTransferInternalException Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Represents an exception thrown when the Background Transfer Service encounters an internal error.
Inheritance Hierarchy
System..::.Object
System..::.Exception
System..::.SystemException
Microsoft.Phone.BackgroundTransfer..::.BackgroundTransferInternalException
Namespace: Microsoft.Phone.BackgroundTransfer
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
Syntax
Public NotInheritable Class BackgroundTransferInternalException _
Inherits SystemException
public sealed class BackgroundTransferInternalException : SystemException
The BackgroundTransferInternalException type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Data | Gets a collection of key/value pairs that provide additional user-defined information about the exception. (Inherited from Exception.) |
|
HelpLink | Gets or sets a link to the help file associated with this exception. (Inherited from Exception.) |
|
HResult | Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Inherited from Exception.) |
|
InnerException | Gets the Exception instance that caused the current exception. (Inherited from Exception.) |
|
Message | Gets a message that describes the current exception. (Inherited from Exception.) |
|
Source | Gets or sets the name of the application or the object that causes the error. (Inherited from Exception.) |
|
StackTrace | Gets a string representation of the frames on the call stack at the time the current exception was thrown. (Inherited from Exception.) |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
.gif "Protected method") |
Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
|
GetBaseException | When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Inherited from Exception.) |
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
GetType | Gets the runtime type of the current instance. (Inherited from Exception.) |
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
ToString | Creates and returns a string representation of the current exception. (Inherited from Exception.) |
Top
Remarks
This error may be returned from a call to Add(BackgroundTransferRequest) or may be exposed through the TransferError property if the system encounters an internal error. It may not be possible for an application to correct these errors from code. The Message field describes the error that was encountered. Possible internal errors include the following:
The total request limit across all applications has been reached.
The HTTP network provider returned an error.
The HTTP network provider returned an error related to content-range request or response.
The HTTP network provider returned a network-related error.
The HTTP network provider returned a slow transfer error.
The isolated storage provider returned an error.
Capabilities
If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.
ID_CAP_NETWORKING |
Windows Phone 8, Windows Phone OS 7.1 |
For more info, see App capabilities and hardware requirements for Windows Phone 8.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1
Platforms
Windows Phone
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.