BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
バックグラウンド タスクのイベント トリガーを設定します。
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 が追加または削除されたときに発生するトリガーを表します。 |