BackgroundTaskBuilder クラス

定義

名前空間:
Microsoft.Windows.ApplicationModel.Background
編集

システムに登録するバックグラウンド タスクを表します。

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTaskBuilder final
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTaskBuilder
function BackgroundTaskBuilder()
Public NotInheritable Class BackgroundTaskBuilder
継承
Object Platform::Object IInspectable BackgroundTaskBuilder
属性
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

バックグラウンド タスクを含む UWP アプリを WinUI 3 に移行する方法については、「Windows アプリ SDKバックグラウンド タスク移行戦略ガイド」を参照してください。

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「C++/WinRT のアジャイル オブジェクト」、スレッド化とマーシャリング (C++/CX)、マルチスレッド環境での Windows ランタイム オブジェクトの使用 (.NET)に関するページを参照してください。

Note

内部的には、 BackgroundTaskBuilder は ApplicationData.LocalSettings を使用してバックグラウンド タスク登録情報を格納するため、 LocalSettings コンテナーをクリーンアップすると、以前に登録されたバックグラウンド タスクの機能に影響する可能性があります。 ローカル設定の詳細については、「 設定とその他のアプリ データを格納および取得する」を参照してください。

コンストラクター

名前 説明
BackgroundTaskBuilder()

新しい BackgroundTaskBuilder オブジェクトを 作成します。

プロパティ

名前 説明
Name

バックグラウンド タスクの名前を取得または設定します。
TaskGroup

バックグラウンド タスクの登録を個別に管理できるように、グループ識別子を取得および設定します。

メソッド

名前 説明
AddCondition(IBackgroundCondition)

バックグラウンド タスクに条件を追加します。
Register()

バックグラウンド タスクをシステムに登録します。
Register(String)

バックグラウンド タスクをシステムに登録します。
SetTaskEntryPointClsid(Guid)

既存の BackgroundTaskBuilder オブジェクトを使用して、バックグラウンド タスクの COM CLSID エントリ ポイントを割り当てます。
SetTrigger(IBackgroundTrigger)

バックグラウンド タスクのイベント トリガーを設定します。

適用対象

こちらもご覧ください