次の方法で共有


Windows.Networking.BackgroundTransfer 名前空間

アプリ内で高度なダウンロードとアップロードの転送機能を有効にします。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。

注意

バックグラウンド転送は、主に、ビデオ、音楽、大きな画像などのリソースの長期的な転送操作用に設計されています。 小規模なリソース (つまり、2 KB) の転送を伴う短期的な操作の場合は、HTTP API をお勧めします。 HttpClient が推奨され、UWP アプリでサポートされているすべての言語で使用できます。 XHR は JavaScript で使用できます。 IXHR2 は C++ で使用できます。

クラス

BackgroundDownloader

CreateDownload を使用してダウンロード操作を実際に作成する前にダウンロードを構成するために使用されます。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。

注意

バックグラウンド転送は、主に、ビデオ、音楽、大きな画像などのリソースの長期的な転送操作用に設計されています。 小規模なリソース (つまり、2 KB) の転送を伴う短期的な操作の場合は、 Windows.Web.Http 名前空間を使用します。

BackgroundTransferCompletionGroup

すべての操作が完了した後 (操作が正常に完了した場合) またはエラーで失敗した後にバックグラウンド タスクをトリガーする一連のバックグラウンド転送操作 (DownloadOperation オブジェクトまたは UploadOperation オブジェクト) を表します。

BackgroundTransferCompletionGroupTriggerDetails

IBackgroundTaskRun メソッドからのみアクセスできる BackgroundTransferCompletionGroup に関する情報が含まれます。

BackgroundTransferContentPart

マルチパート転送要求のコンテンツ部分を表します。 各 BackgroundTransferContentPart オブジェクトは、テキスト コンテンツの単一の文字列または単一のファイル ペイロードを表すことができますが、両方は表しません。

BackgroundTransferError

転送操作中に発生したエラーを提供するために使用されます。

BackgroundTransferGroup

複数のダウンロード操作またはアップロード操作を関連付けるために使用される名前付きグループ。 このクラスを使用すると、アプリでこれらのグループを簡単に作成し、ダウンロードとアップロードを同時、シリアル、または優先順位に基づいて完了できます。

たとえば、ユーザーが人気のあるテレビシリーズからエピソードをダウンロードしてwatchする場合、アプリはシリーズの最も初期のエピソードに優先順位を付けたり、最初にダウンロードするエピソードを選択したりできます。

BackgroundTransferRangesDownloadedEventArgs

増分ダウンロードの進行状況イベントに関する情報へのアクセスを提供します。

BackgroundUploader

CreateUpload を使用してアップロード操作を実際に作成する前にアップロードを構成するために使用されます。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。

注意

バックグラウンド転送は、主に、ビデオ、音楽、大きな画像などのリソースの長期的な転送操作用に設計されています。 小規模なリソース (つまり、2 KB) の転送を伴う短期的な操作の場合は、 Windows.Web.Http 名前空間を使用します。

ContentPrefetcher

プリフェッチする Web リソースを指定するためのプロパティを提供します。 Windows はヒューリスティックを使用して、ユーザーがアプリを起動する前に、指定されたリソースのダウンロードを試みます。

DownloadOperation

非同期ダウンロード操作を実行します。 バックグラウンド転送サンプルでは、この機能を示します。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。

ResponseInformation

サーバー応答によって返されるデータを表します。

UnconstrainedTransferRequestResult

BackgroundDownloader オブジェクトまたは BackgroundUploader オブジェクトからの制約のない転送の要求の結果を表します。

制約のない転送操作は、通常、バックグラウンド ネットワーク操作に関連付けられているリソース制限なしで、デバイスがバッテリで実行されている間に実行できます。

UploadOperation

非同期アップロード操作を実行します。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。

構造体

BackgroundDownloadProgress

ダウンロード操作に関する状態情報が含まれます。

BackgroundTransferFileRange

ファイル転送操作に関する状態情報が含まれます。

BackgroundUploadProgress

アップロード操作に関する状態情報が含まれます。

インターフェイス

IBackgroundTransferBase

バックグラウンド転送操作を表します。

IBackgroundTransferContentPartFactory

BackgroundTransferContentPart オブジェクトを作成します。

IBackgroundTransferOperation

バックグラウンド転送操作を表します。

IBackgroundTransferOperationPriority

このインターフェイスを使用して、 BackgroundTransferGroup 内でのダウンロードまたはアップロードの優先順位を決定します。 指定できる値は、 BackgroundTransferPriority 列挙体によって定義されます。

列挙型

BackgroundTransferBehavior

BackgroundTransferGroup 内のダウンロードとアップロードが同時に実行されるか、シリアルで実行されるかを示すために使用される値を定義します。

BackgroundTransferCostPolicy

従量制課金ネットワークで転送を実行できるかどうかを指定するために使用される値を定義します。

BackgroundTransferPriority

BackgroundTransfer 操作 (ダウンロードまたはアップロード) がアプリ内のスケジュールに関して持つ優先度を示します。

BackgroundTransferStatus

転送操作の状態値を定義します。

注釈

ほとんどのプラットフォームでは、バックグラウンド転送は、アプリが中断されている場合や終了した場合でも、ファイルの転送 (ダウンロードまたはアップロード) を続行します。 アプリが起動したら、 BackgroundDownloader.GetCurrentDownloadsAsync または BackgroundUploader.GetCurrentUploadsAsync を呼び出して、不完全な転送をすべて列挙する必要があります。 次に、それぞれ DownloadOperation.AttachAsync または UploadOperation.AttachAsync を呼び出します。 これにより、転送の最新の状態が取得され、システムの再起動後に転送が再開されます。 DownloadOperation.IsRandomAccessRequired が の場合、true再起動後にダウンロードが自動的に再開されます。 その場合でも AttachAsync を呼び出す必要があります。 転送が完了したときにアプリが実行されている場合 (つまり、 AttachAsync の呼び出しが返されたとき)、応答で作業を行うことができます。 または、 BackgroundTransferCompletionGroup を使用して、転送が完了したときにバックグラウンド タスクを起動することもできます。

Xbox では、バックグラウンド転送では、アプリがフォアグラウンドにある間のみファイルを転送 (ダウンロードまたはアップロード) します。 アプリが中断、バックグラウンドに配置、または終了すると、アプリのバックグラウンド転送が中断されます。 アプリがフォアグラウンドで再度実行されると、その転送が自動的に再開されます。

こちらもご覧ください