次の方法で共有


BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) メソッド

定義

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

public:
 virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;
void SetTrigger(IBackgroundTrigger const& trigger);
public void SetTrigger(IBackgroundTrigger trigger);
function setTrigger(trigger)
Public Sub SetTrigger (trigger As IBackgroundTrigger)

パラメーター

trigger
IBackgroundTrigger

SystemTriggerTimeTriggerNetworkOperatorNotificationTrigger などのイベント トリガー オブジェクトのインスタンス。

注釈

アプリケーションでは、バックグラウンド タスクのイベント トリガーの種類を指定するだけでなく、マニフェストの セクションで <Extensions><Extension><BackgroundTasks> イベント トリガーの種類を使用するバックグラウンド タスクも有効にする必要があります。 有効な型は、次のとおりです。

  • <Task Type="audio"/>
  • <Task Type="timer"/>
  • <Task Type="systemEvent"/>
  • <Task Type="pushNotification"/>
  • <Task Type="realTimeCommunication"/>

マニフェストでバックグラウンド タスクの種類が指定されていないか、正しく指定されていない場合、その種類のバックグラウンド タスクの使用を試みる呼び出しは失敗します。

トリガーの一覧:

トリガー 説明
ActivitySensorTrigger アプリケーションがアクティビティ センサーに応答する必要がある場合に使用されます。
AppBroadcastTrigger アプリケーションがゲームプレイブロードキャストを開始したときにバックグラウンド タスクを実行するようにトリガーします。
ApplicationTrigger アプリケーション内からバックグラウンド タスクをトリガーします。
AppointmentStoreNotificationTrigger 予定ストアへの変更を処理するためのバックグラウンド タスクを起動するトリガー。
BluetoothLEAdvertisementPublisherTrigger バックグラウンドで Bluetooth LE アドバタイズをアドバタイズするために登録されるトリガーを表します。
CachedFileUpdaterTrigger バックグラウンド タスクをトリガーして、キャッシュ されたファイル アップデーター コントラクトを有効にします。
ChatMessageNotificationTrigger テキスト メッセージの通知がある場合にアクティブ化されるトリガーを表します。
ChatMessageReceivedNotificationTrigger コンテンツに従ってフィルター処理する必要がある受信メッセージを処理するバックグラウンド タスクを起動するトリガーを表します。
CommunicaionBlockingAppSetAsActiveTrigger 優先ブロック アプリとして選択されている場合に通信ブロック アプリケーションをアクティブ化するトリガーを表します。
ContactStoreNotificationTrigger 連絡先ストアへの変更を処理するためのバックグラウンド タスクを起動するトリガーを表します。
ContentPrefetchTrigger Web リソースをプリフェッチするときにカスタム ハンドラーを実行する機能を提供します。
CustomSystemEventTrigger を定義できるカスタム システム トリガー。
DeviceConnectionChangeTrigger デバイスの実行時間の長い更新 (ファームウェアまたは設定) を開始するためにアプリケーションがトリガーできるイベントを表します。
DeviceManufacturerNotificationTrigger デバイスの実行時間の長い更新 (ファームウェアまたは設定) を開始するためにアプリケーションがトリガーできるイベントを表します。
DeviceUseTrigger Windows ランタイム アプリがトリガーして、デバイスまたはセンサーで実行時間の長い操作を開始できるイベントを表します。
EmailStoreNotificationTrigger 電子メール ストアへの変更の通知を有効にするトリガーを表します。
GattCharacteristicNotificationTrigger Bluetooth LE GATT 特性の受信変更通知を受信したときにバックグラウンド タスクを起動するトリガーを表します。
GattServiceProviderTrigger バックグラウンドで永続化できる汎用属性 (GATT) サービスを構築します。
GeovisitTrigger 訪問関連のバックグラウンド タスクをトリガーするイベントを表します。
LocationTrigger バックグラウンド タスクをトリガーする場所イベントを表します。 これはジオフェンシングに使用されます。
メンテナンス トリガー システムが AC 電源に接続されている場合にのみ実行されるメンテナンス トリガーを表します。
MediaProcessingTrigger メディア処理を実行するためのバックグラウンド タスクを起動するトリガーを表します。
MobileBroadbandDeviceServiceNotificationTrigger ネットワークが SIM ツール コマンドを送信するときにアクティブになるトリガーを表します。 この通知を受け取ったアプリは、SIM ツール コマンドを処理します。
MobileBroadbandPcoDataChangeTrigger バックグラウンド タスクの実行をトリガーする携帯ネットワーク プロトコル構成オプション変更イベントを表します。
MobileBroadbandPinLockStateChangeTrigger SIM PIN ロック状態がいつ変更されたかを示すトリガーを表します。
MobileBroadbandRadioStateChangeTrigger モバイル ブロードバンド無線の状態が変更されたタイミングを示すトリガーを表します。 たとえば、モバイル デバイスが機内モードに切り替わると、このトリガーがアクティブになります。
MobileBroadbandRegistrationStateChangeTrigger モバイル ブロードバンド登録の状態が変更されたタイミングを示すトリガーを表します。 たとえば、モバイル デバイスがローミングに切り替わると、このトリガーがアクティブになります。
NetworkOperatorDataUsageTrigger ローカル データ カウンターがモバイル ブロードバンド インターフェイスでの使用量 (送受信バイト数) が実用的なしきい値によって変更されたと推定したときにバックグラウンド タスクを起動するトリガーを表します。
NetworkOperatorHotspotAuthenticationTrigger モバイル ネットワーク オペレーターのホットスポット認証トリガーを表します。
NetworkOperatorNotificationTrigger モバイル ネットワーク オペレーター通知トリガーを表します。
PaymentAppCanMakePaymentTrigger PaymentAppCanMakePayment トリガーを表します。
PhoneTrigger バックグラウンド タスクをトリガーする電話イベントを表します。
PushNotificationTrigger 未加工の通知の受信に応答して、アプリでバックグラウンド作業項目を呼び出すトリガーを表します。
RcsEndUserMessageAvailableTrigger 新しいリッチ コミュニケーション サービス (RCS) メッセージが使用可能になったときにバックグラウンド タスクを起動するトリガーを表します。
RfcommConnectionTrigger RFCOMM 受信または送信接続が確立されたときにバックグラウンド タスクを起動するトリガーを表します。
SecondaryAuthenticationFactorAuthenticationTrigger コンパニオン デバイスに代わってバックグラウンド タスクを起動するトリガーを表します。
SensorDataThresholdTrigger センサーのしきい値制限を超えたときに応答するトリガーを表します。
SmartCardTrigger スマート カードによってトリガーされるイベントを表します。
SmsMessageReceivedTrigger SMS メッセージが到着したときに発生するトリガーを表します。
SocketActivityTrigger ソケット アクティビティを処理するためのバックグラウンド タスクを起動するトリガーを表します。
StorageLibraryChangeTrackerTrigger バックグラウンド タスクの実行をトリガーする StorageFolder 内のファイル変更を表します。
StorageLibraryContentChangedTrigger 指定したライブラリでファイルが変更されたときに起動するトリガーを作成します。
SystemCondition バックグラウンド タスクを実行するために有効にする必要があるシステム条件を表します。
SystemTrigger バックグラウンド タスクの実行をトリガーするシステム イベントを表します。
TetheringEntitlementCheckTrigger バックグラウンド タスクの実行をトリガーするテザリング イベントを表します。
TimeTrigger バックグラウンド タスクの実行をトリガーする時間イベントを表します。
ToastNotificationActionTrigger ユーザーが対話型トースト通知に対してアクションを実行したときにバックグラウンド タスクを実行するイベントを表します。
ToastNotificationHistoryChangedTrigger アプリのトースト通知の履歴がクリアされたとき、1 つ以上のトースト通知がアプリの通知履歴に追加または削除されたとき、またはアプリの 1 つ以上のトースト通知の有効期限が切れ、通知履歴から削除されたときにバックグラウンド タスクを実行するイベントを表します。
UserNotificationChangedTrigger UserNotification が追加または削除されたときに発生するトリガーを表します。

適用対象