TileUpdater.StartPeriodicUpdateBatch 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence) |
開始在更新程式所系結之磚上迴圈的一系列計時更新。 更新內容是從指定的統一資源識別項陣列擷取 (URI) ，第一次更新會立即發生，後續更新會在後續定期發生。 注意 若要使用此功能，您必須先呼叫 EnableNotificationQueue來啟用磚的通知佇列。 |
| StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence) |
開始在更新程式所系結之磚上迴圈的一系列計時更新。 更新內容會從指定的統一資源識別項陣列擷取， (URI) ，並在指定時間之後于定期間隔發生後續更新。 注意 若要使用此功能，您必須先呼叫 EnableNotificationQueue來啟用磚的通知佇列。 |
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
開始在更新程式所系結之磚上迴圈的一系列計時更新。 更新內容是從指定的統一資源識別項陣列擷取 (URI) ，第一次更新會立即發生，後續更新會在後續定期發生。
注意
若要使用此功能，您必須先呼叫 EnableNotificationQueue來啟用磚的通知佇列。
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, PeriodicUpdateRecurrence const& requestedInterval);[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, PeriodicUpdateRecurrence requestedInterval);function startPeriodicUpdateBatch(tileContents, requestedInterval)Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), requestedInterval As PeriodicUpdateRecurrence)參數
- tileContents
最多五個統一資源識別項的陣列 (URI) ，從中擷取迴圈磚更新的 XML 內容。 如果陣列包含五個以上的統一資源識別項 (URI) ，此方法將會失敗。
- requestedInterval
- PeriodicUpdateRecurrence
在 startTime進行初始更新之後，系統會輪詢統一資源識別項 (URI) 的頻率，以取得新的磚內容。
- 屬性
備註
搭配定期更新使用通知佇列
若要使用通知佇列，您必須先使用這行程式碼為您的磚啟用它：
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
此 API 只需要在應用程式的存留期內呼叫一次，但在每次應用程式啟動時呼叫它並沒有任何損害。
在定期通知的情況下，會為每個通知提供唯一的 URL。 Windows 會定期輪詢每個 URL 以取得更新的通知內容。 從每個 URL 傳回的內容承載應該包含所有支援的磚大小的通知 XML 版本。 每個輪詢的 URL 也可以選擇性地傳回自己的唯一到期時間和標記值。
標記定期更新的通知
啟用通知佇列後，您的磚最多可以迴圈五個已排入佇列的通知。 一般而言，當新的通知送達時，佇列中會取代最舊的通知。 不過，通知可以指定標記，讓具有特定標籤的新通知會以相同的標記取代較舊的通知，而不論其在佇列中的位置為何。
標記是最多 16 個字元的選擇性字串，可在通知上設定為識別碼。 如果新的通知與佇列中已有的通知一樣標記送達，新的通知會取代舊的通知，而不是落在預設的先進先出佇列行為之下。 這可防止兩個版本的相同通知同時出現在佇列中，其中一個版本已過期。
在定期通知的情況下，標籤會在通知 HTTP 回應訊息的 X-WNS-Tag 標頭中提供，其中也包含通知的內容。 系統會傳送此訊息，以回應系統對通知統一資源識別項的定期呼叫 (URI) 。 標頭名稱和標記值不區分大小寫。
以下顯示一個範例：
X-WNS-Tag: stockMSFT
設定定期更新的到期時間
定期通知預設會在三天后到期。 如果您的通知內容有明顯不同的實用生命週期，較短或更長，您應該為每個通知明確設定到期時間。 這可防止佇列中剩餘過時或不相關的內容。 如果使用者的電腦長時間失去網際網路連線，這特別重要。
例如，在作用中交易期間，建議您讓股票應用程式將股票價格通知的到期時間設定為輪詢間隔的兩倍，例如當您每半小時輪詢更新時到期的通知。 在新聞應用程式的情況下，顯示熱門每日新聞的磚有一天的到期日會適用。
針對定期通知，到期時間是在通知 HTTP 回應訊息的 X-WNS-Expires 標頭中設定。 到期時間會以 HTTP-date 表示，它會使用下列範例所示的其中一種格式：
- Sun， 06 Nov 1994 08：49：37 GMT
- 星期日，06-Nov-94 08：49：37 GMT
- Sun Nov 6 08：49：37 1994
如需 HTTP 日期格式的詳細資訊，請參閱 World Wide Web Consortium (W3C) 3 通訊協定參數 檔。
如需搭配通知佇列使用之定期通知的完整實作範例，請參閱 推播和定期通知範例中的案例 3， (封存) 。
另請參閱
- StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- 如何設定磚的定期通知
- 定期通知的指導方針和檢查清單
- 磚和磚通知概觀
適用於
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
開始在更新程式所系結之磚上迴圈的一系列計時更新。 更新內容會從指定的統一資源識別項陣列擷取， (URI) ，並在指定時間之後于定期間隔發生後續更新。
注意
若要使用此功能，您必須先呼叫 EnableNotificationQueue來啟用磚的通知佇列。
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, DateTime startTime, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, DateTime const& startTime, PeriodicUpdateRecurrence const& requestedInterval);[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, System.DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval);function startPeriodicUpdateBatch(tileContents, startTime, requestedInterval)Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), startTime As DateTimeOffset, requestedInterval As PeriodicUpdateRecurrence)參數
- tileContents
最多五個統一資源識別項的陣列 (URI) ，從中擷取迴圈磚更新的 XML 內容。 如果陣列包含五個以上的統一資源識別項 (URI) ，此方法將會失敗。
- startTime
- DateTime DateTimeOffset
初始統一資源識別項 (URI) 應該先輪詢新內容的時間。
- requestedInterval
- PeriodicUpdateRecurrence
在 startTime進行初始更新之後，系統會輪詢統一資源識別項 (URI) 的頻率，以取得新的磚內容。
- 屬性
備註
搭配定期更新使用通知佇列
若要使用通知佇列，您必須先使用這行程式碼為您的磚啟用它：
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
此 API 只需要在應用程式的存留期內呼叫一次，但在每次應用程式啟動時呼叫它並沒有任何損害。
在定期通知的情況下，會為每個通知提供唯一的 URL。 Windows 會定期輪詢每個 URL 以取得更新的通知內容。 從每個 URL 傳回的內容承載應該包含所有支援的磚大小的通知 XML 版本。 每個輪詢的 URL 也可以選擇性地傳回自己的唯一到期時間和標記值。
標記定期更新的通知
啟用通知佇列後，您的磚最多可以迴圈五個已排入佇列的通知。 一般而言，當新的通知送達時，佇列中會取代最舊的通知。 不過，通知可以指定標記，讓具有特定標籤的新通知會以相同的標記取代較舊的通知，而不論其在佇列中的位置為何。
標記是最多 16 個字元的選擇性字串，可在通知上設定為識別碼。 如果新的通知與佇列中已有的通知一樣標記送達，新的通知會取代舊的通知，而不是落在預設的先進先出佇列行為之下。 這可防止兩個版本的相同通知同時出現在佇列中，其中一個版本已過期。
在定期通知的情況下，標籤會在通知 HTTP 回應訊息的 X-WNS-Tag 標頭中提供，其中也包含通知的內容。 系統會傳送此訊息，以回應系統對通知統一資源識別項的定期呼叫 (URI) 。 標頭名稱和標記值不區分大小寫。
以下顯示一個範例：
X-WNS-Tag: stockMSFT
設定定期更新的到期時間
磚預設會在三天后到期。 如果您的通知內容有明顯不同的實用生命週期，較短或更長，您應該為每個通知明確設定到期時間。 這可防止佇列中剩餘過時或不相關的內容。 如果使用者的電腦長時間失去網際網路連線，這特別重要。
例如，在作用中交易期間，建議您讓股票應用程式將股票價格通知的到期時間設定為輪詢間隔的兩倍，例如當您每半小時輪詢更新時到期的通知。 在新聞應用程式的情況下，顯示熱門每日新聞的磚有一天的到期日會適用。
針對定期通知，到期時間是在通知 HTTP 回應訊息的 X-WNS-Expires 標頭中設定。 到期時間會以 HTTP-date 表示，它會使用下列範例所示的其中一種格式：
- Sun， 06 Nov 1994 08：49：37 GMT
- 星期日，06-Nov-94 08：49：37 GMT
- Sun Nov 6 08：49：37 1994
如需 HTTP 日期格式的詳細資訊，請參閱 World Wide Web Consortium (W3C) 3 通訊協定參數 檔。
如需搭配通知佇列使用之定期通知的完整實作範例，請參閱 推播和定期通知範例中的案例 3， (封存) 。
另請參閱
- StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- 如何設定磚的定期通知
- 定期通知的指導方針和檢查清單
- 磚和磚通知概觀