Windows.Networking.BackgroundTransfer 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリ内で高度なダウンロードとアップロードの転送機能を有効にします。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。
注意
バックグラウンド転送は、主に、ビデオ、音楽、大きな画像などのリソースの長期的な転送操作用に設計されています。 小規模なリソース (つまり、2 KB) の転送を伴う短期的な操作の場合は、HTTP API をお勧めします。 HttpClient が推奨され、UWP アプリでサポートされているすべての言語で使用できます。 XHR は JavaScript で使用できます。 IXHR2 は C++ で使用できます。
クラス
| BackgroundDownloader |
CreateDownload を使用してダウンロード操作を実際に作成する前にダウンロードを構成するために使用されます。 バックグラウンド転送機能の概要については、「 バックグラウンドでのデータの転送」を参照してください。 コード例の バックグラウンド転送サンプル をダウンロードします。 注意 バックグラウンド転送は、主に、ビデオ、音楽、大きな画像などのリソースの長期的な転送操作用に設計されています。 小規模なリソース (つまり、2 KB) の転送を伴う短期的な操作の場合は、 Windows.Web.Http 名前空間を使用します。 |
| BackgroundTransferCompletionGroup |
すべての操作が完了した後 (操作が正常に完了した場合) またはエラーで失敗した後にバックグラウンド タスクをトリガーする一連のバックグラウンド転送操作 (DownloadOperation オブジェクトまたは UploadOperation オブジェクト) を表します。 |
| BackgroundTransferCompletionGroupTriggerDetails |
IBackgroundTask の Run メソッドからのみアクセスできる 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 | |
| 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 では、バックグラウンド転送では、アプリがフォアグラウンドにある間のみファイルを転送 (ダウンロードまたはアップロード) します。 アプリが中断、バックグラウンドに配置、または終了すると、アプリのバックグラウンド転送が中断されます。 アプリがフォアグラウンドで再度実行されると、その転送が自動的に再開されます。
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示