情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

BackgroundTransferService.Remove メソッド

2013/12/12

指定した ID のバックグラウンド転送要求の削除を試みます。

Namespace:  Microsoft.Phone.BackgroundTransfer
アセンブリ:  Microsoft.Phone (Microsoft.Phone.dll 内)

public static void Remove(
	BackgroundTransferRequest request
)

パラメーター

request
型: Microsoft.Phone.BackgroundTransfer.BackgroundTransferRequest
削除する転送要求。

Find(String) メソッドを使用して、特定の要求 ID に関連付けられた BackgroundTransferRequest オブジェクトを取得します。取得されたオブジェクトを Remove に渡すと、システムから削除することができます。

転送を削除した後、TransferStatus がまだ Completed になっていない場合は、TransferStatusChanged イベントが発生し、要求の TransferError プロパティが InvalidOperationException に設定され、"要求は以前に取り消されました。" というメッセージが表示されます。

このメソッドは、次のいずれかの例外をスローします。

ArgumentNullException

指定された BackgroundTransferRequest を null にすることはできません。

InvalidOperationException

要求は以前に取り消されました。

指定された転送要求が、キューで見つかりませんでした。

Windows Phone OS

サポート: 8.0, 7.1

表示: