TileUpdater.StartPeriodicUpdateBatch Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence) |
Inizia una serie di aggiornamenti temporali a cui viene eseguito il ciclo nel riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier), il primo aggiornamento che si verifica immediatamente e gli aggiornamenti successivi che si verificano a intervalli periodici. Nota Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando EnableNotificationQueue. |
| StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence) |
Inizia una serie di aggiornamenti temporali a cui viene eseguito il ciclo nel riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier) specificati con aggiornamenti a partire da un momento specificato e gli aggiornamenti successivi che si verificano a intervalli periodici. Nota Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando EnableNotificationQueue. |
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
Inizia una serie di aggiornamenti temporali a cui viene eseguito il ciclo nel riquadro a cui è associato l'aggiornamento. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier), il primo aggiornamento che si verifica immediatamente e gli aggiornamenti successivi che si verificano a intervalli periodici.
Nota
Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando 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)Parametri
- tileContents
Matrice di fino a cinque URI (Uniform Resource Identifier) da cui verrà recuperato il contenuto XML degli aggiornamenti del riquadro del ciclo. Se la matrice contiene più di cinque URI (Uniform Resource Identifier), il metodo avrà esito negativo.
- requestedInterval
- PeriodicUpdateRecurrence
Frequenza con cui viene eseguito il polling dell'URI (Uniform Resource Identifier) per il nuovo contenuto del riquadro, seguendo l'aggiornamento iniziale all'inizioTime.
- Attributi
Commenti
Uso della coda di notifica con aggiornamenti periodici
Per usare la coda di notifica, è prima necessario abilitarla per il riquadro con questa riga di codice:
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
Questa API deve essere chiamata solo una volta nella durata dell'app, ma non vi è alcun danno nella chiamata ogni volta che l'app viene avviata.
Nel caso di notifiche periodiche, viene fornito un URL univoco per ogni notifica. Ogni URL viene eseguito il polling su base periodica da Windows per il contenuto di notifica aggiornato. Il payload del contenuto restituito da ogni URL deve contenere versioni del codice XML di notifica per tutte le dimensioni dei riquadri supportate. Ogni URL sottoposto a polling può anche restituire facoltativamente il proprio valore univoco di scadenza e tag.
Assegnazione di tag alle notifiche per gli aggiornamenti periodici
Con la coda di notifica abilitata, il riquadro può essere eseguito tramite un massimo di cinque notifiche in coda. In genere, la notifica meno recente viene sostituita nella coda quando arriva una nuova notifica. Tuttavia, le notifiche possono essere date a un tag in modo che una nuova notifica con un tag specifico sostituisca una notifica precedente con lo stesso tag, indipendentemente dal relativo posto nella coda.
I tag sono stringhe facoltative di fino a 16 caratteri che possono essere impostate su una notifica come identificatore. Se una nuova notifica arriva con lo stesso tag di una notifica già nella coda, la nuova notifica sostituisce quella precedente anziché rientrare nel comportamento predefinito della prima coda. Ciò impedisce il caso in cui due versioni della stessa notifica, una delle quali non aggiornate, siano presenti nella coda contemporaneamente.
Nel caso delle notifiche periodiche, i tag vengono forniti nell'intestazione X-WNS-Tag del messaggio di risposta HTTP della notifica, che include anche il contenuto della notifica. Questo messaggio viene inviato in risposta alla chiamata periodica del sistema all'URI (Uniform Resource Identifier) della notifica. Il nome dell'intestazione e il valore del tag sono senza distinzione tra maiuscole e minuscole.
Di seguito è riportato un esempio:
X-WNS-Tag: stockMSFT
Impostazione di un'ora di scadenza per gli aggiornamenti periodici
Le notifiche periodiche scadono per impostazione predefinita dopo tre giorni. Se il contenuto della notifica ha una durata utile significativamente diversa, più breve o più lunga, è necessario impostare in modo esplicito un'ora di scadenza per ogni notifica. Ciò impedisce che il contenuto non aggiornato o irrilevante rimanga nella coda. Ciò è particolarmente importante se il computer dell'utente perde la connettività Internet per un lungo periodo di tempo.
Ad esempio, durante il trading attivo, è consigliabile che un'app per le scorte imposta la scadenza su una notifica di prezzo azionario su due volte dell'intervallo di polling, ad esempio una notifica che scade un'ora dopo che viene inviata se si esegue il polling per un aggiornamento ogni mezz'ora. Nel caso di un'app di notizie, una scadenza di un giorno per un riquadro che mostra le principali notizie giornaliere sarebbe appropriato.
Per le notifiche periodiche, l'ora di scadenza viene impostata nell'intestazione X-WNS-Expires del messaggio di risposta HTTP della notifica. L'ora di scadenza viene espressa come data HTTP, che usa uno dei formati illustrati in questi esempi:
- Sun, 06 novembre 1994 08:49:37 GMT
- Domenica, 06-Nov-94 08:49:37 GMT
- Sole 6 08:49:37 1994
Per altre informazioni sul formato di data HTTP, vedere il documento World Wide Web Consortium (W3C) 3 Protocol Parameters .
Per un esempio di implementazione completa delle notifiche periodiche usate insieme alla coda di notifica, vedere Scenario 3 nell'esempio di notifiche push e periodico (archiviato).
Vedi anche
- StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- Come configurare notifiche periodiche per i riquadri
- Linee guida ed elenco di controllo per le notifiche periodiche
- Panoramica della notifica riquadro e riquadro
Si applica a
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
Inizia una serie di aggiornamenti temporali a cui è associato il ciclo nel riquadro a cui è associato l'updater. Il contenuto dell'aggiornamento viene recuperato da una matrice di URI (Uniform Resource Identifier) specificato con aggiornamenti a partire da un momento specificato e gli aggiornamenti successivi che si verificano a intervalli periodici successivamente.
Nota
Per usare questa funzionalità, è prima necessario abilitare la coda di notifica del riquadro chiamando 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)Parametri
- tileContents
Matrice di fino a cinque URI (Uniform Resource Identifier) da cui verrà recuperato il contenuto XML degli aggiornamenti del riquadro del ciclo. Se la matrice contiene più di cinque URI (Uniform Resource Identifier), il metodo avrà esito negativo.
- startTime
- DateTime DateTimeOffset
Ora in cui deve essere eseguito il polling dell'URI (Uniform Resource Identifier) iniziale per il nuovo contenuto.
- requestedInterval
- PeriodicUpdateRecurrence
Frequenza con cui viene eseguito il polling dell'URI (Uniform Resource Identifier) per il nuovo contenuto del riquadro, seguendo l'aggiornamento iniziale all'inizioTime.
- Attributi
Commenti
Uso della coda di notifica con aggiornamenti periodici
Per usare la coda di notifica, è prima necessario abilitarla per il riquadro con questa riga di codice:
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
Questa API deve essere chiamata solo una volta nella durata dell'app, ma non vi è alcun danno nella chiamata ogni volta che l'app viene avviata.
Nel caso di notifiche periodiche, viene fornito un URL univoco per ogni notifica. Ogni URL viene eseguito il polling su base periodica da Windows per il contenuto di notifica aggiornato. Il payload del contenuto restituito da ogni URL deve contenere versioni del codice XML di notifica per tutte le dimensioni dei riquadri supportate. Ogni URL sottoposto a polling può anche restituire facoltativamente il proprio valore univoco di scadenza e tag.
Assegnazione di tag alle notifiche per gli aggiornamenti periodici
Con la coda di notifica abilitata, il riquadro può essere eseguito tramite un massimo di cinque notifiche in coda. In genere, la notifica meno recente viene sostituita nella coda quando arriva una nuova notifica. Tuttavia, le notifiche possono essere date a un tag in modo che una nuova notifica con un tag specifico sostituisca una notifica precedente con lo stesso tag, indipendentemente dal relativo posto nella coda.
I tag sono stringhe facoltative di fino a 16 caratteri che possono essere impostate su una notifica come identificatore. Se una nuova notifica arriva con lo stesso tag di una notifica già nella coda, la nuova notifica sostituisce quella precedente anziché rientrare nel comportamento predefinito della prima coda. Ciò impedisce il caso in cui due versioni della stessa notifica, una delle quali non aggiornate, siano presenti nella coda contemporaneamente.
Nel caso delle notifiche periodiche, i tag vengono forniti nell'intestazione X-WNS-Tag del messaggio di risposta HTTP della notifica, che include anche il contenuto della notifica. Questo messaggio viene inviato in risposta alla chiamata periodica del sistema all'URI (Uniform Resource Identifier) della notifica. Il nome dell'intestazione e il valore del tag sono senza distinzione tra maiuscole e minuscole.
Di seguito è riportato un esempio:
X-WNS-Tag: stockMSFT
Impostazione di un'ora di scadenza per gli aggiornamenti periodici
I riquadri scadono per impostazione predefinita dopo tre giorni. Se il contenuto della notifica ha una durata utile significativamente diversa, più breve o più lunga, è necessario impostare in modo esplicito un'ora di scadenza per ogni notifica. Ciò impedisce che il contenuto non aggiornato o irrilevante rimanga nella coda. Ciò è particolarmente importante se il computer dell'utente perde la connettività Internet per un lungo periodo di tempo.
Ad esempio, durante il trading attivo, è consigliabile che un'app per le scorte imposta la scadenza su una notifica di prezzo azionario su due volte dell'intervallo di polling, ad esempio una notifica che scade un'ora dopo che viene inviata se si esegue il polling per un aggiornamento ogni mezz'ora. Nel caso di un'app di notizie, una scadenza di un giorno per un riquadro che mostra le principali notizie giornaliere sarebbe appropriato.
Per le notifiche periodiche, l'ora di scadenza viene impostata nell'intestazione X-WNS-Expires del messaggio di risposta HTTP della notifica. L'ora di scadenza viene espressa come data HTTP, che usa uno dei formati illustrati in questi esempi:
- Sun, 06 novembre 1994 08:49:37 GMT
- Domenica, 06-Nov-94 08:49:37 GMT
- Sole 6 08:49:37 1994
Per altre informazioni sul formato di data HTTP, vedere il documento World Wide Web Consortium (W3C) 3 Protocol Parameters .
Per un esempio di implementazione completa delle notifiche periodiche usate insieme alla coda di notifica, vedere Scenario 3 nell'esempio di notifiche push e periodico (archiviato).
Vedi anche
- StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- Come configurare notifiche periodiche per i riquadri
- Linee guida ed elenco di controllo per le notifiche periodiche
- Panoramica della notifica riquadro e riquadro