BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) メソッド

定義

名前空間:

Windows.ApplicationModel.Background

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

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

SystemTrigger、TimeTrigger、NetworkOperatorNotificationTrigger などのイベント トリガー オブジェクトのインスタンス。

注釈

アプリケーションでは、バックグラウンド タスクのイベント トリガーの種類を指定するだけでなく、マニフェストの セクションで <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 が追加または削除されたときに発生するトリガーを表します。