TileUpdater.StartPeriodicUpdateBatch Método

  • Referência

Definição

Namespace:
Windows.UI.Notifications

Sobrecargas

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado, a primeira atualização ocorrendo imediatamente e atualizações subsequentes ocorrendo no intervalo periódico posteriormente.

Observação

Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando EnableNotificationQueue.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado com atualizações começando em um horário especificado e atualizações subsequentes ocorrendo no intervalo periódico posteriormente.

Observação

Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando EnableNotificationQueue.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Editar

Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado, a primeira atualização ocorrendo imediatamente e atualizações subsequentes ocorrendo no intervalo periódico posteriormente.

Observação

Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando 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)

Parâmetros

tileContents

IIterable<Uri>

IEnumerable<Uri>

Uma matriz de até cinco URI (Uniform Resource Identifier) da qual o conteúdo XML das atualizações de bloco de ciclismo será recuperado. Se a matriz contiver mais de cinco URI (Uniform Resource Identifier), o método falhará.

requestedInterval
PeriodicUpdateRecurrence

A frequência com que o URI (Uniform Resource Identifier) é sondado quanto ao novo conteúdo do bloco, após a atualização inicial em startTime.

Atributos
OverloadAttribute

Comentários

Usando a fila de notificação com atualizações periódicas

Para usar a fila de notificação, primeiro você deve habilitá-la para seu bloco com esta linha de código:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Essa API só precisa ser chamada uma vez no tempo de vida do aplicativo, mas não há nenhum dano em chamá-la sempre que o aplicativo é iniciado.

No caso de notificações periódicas, uma URL exclusiva é fornecida para cada notificação. Cada URL é sondada periodicamente pelo Windows para obter conteúdo de notificação atualizado. A carga de conteúdo retornada de cada URL deve conter versões do XML de notificação para todos os tamanhos de bloco com suporte. Cada URL sondada também pode, opcionalmente, retornar seu próprio tempo de expiração exclusivo e valor de marca.

Marcando notificações para atualizações periódicas

Com a fila de notificação habilitada, o bloco pode percorrer no máximo cinco notificações na fila. Geralmente, a notificação mais antiga é substituída na fila quando uma nova notificação chega. No entanto, as notificações podem receber uma marca para que uma nova notificação com uma marca específica substitua uma notificação mais antiga pela mesma marca, independentemente de seu local na fila.

As marcas são cadeias de caracteres opcionais de até 16 caracteres que podem ser definidas em uma notificação como um identificador. Se uma nova notificação chegar com a mesma marca que uma notificação já na fila, a nova notificação substituirá a antiga em vez de ficar abaixo do comportamento padrão da fila inicial e inicial. Isso impede o caso em que duas versões da mesma notificação, uma delas desatualizada, estejam presentes na fila ao mesmo tempo.

No caso de notificações periódicas, as marcas são fornecidas no cabeçalho X-WNS-Tag da mensagem de resposta HTTP da notificação, que também inclui o conteúdo da notificação. Essa mensagem é enviada em resposta à chamada periódica do sistema para o URI (Uniform Resource Identifier) da notificação. O nome do cabeçalho e o valor da marca não diferenciam maiúsculas de minúsculas.

Um exemplo é mostrado aqui:

X-WNS-Tag: stockMSFT

Definindo um tempo de expiração para atualizações periódicas

As notificações periódicas expiram por padrão após três dias. Se o conteúdo da notificação tiver um tempo de vida útil significativamente diferente, menor ou mais longo, você deverá definir explicitamente um tempo de expiração para cada notificação. Isso impede que conteúdo obsoleto ou irrelevante permaneça na fila. Isso é especialmente importante se o computador do usuário perder a conectividade com a Internet por um longo período de tempo.

Por exemplo, durante a negociação ativa, seria aconselhável que um aplicativo de ações definisse a expiração de uma notificação de preço das ações para o dobro do intervalo de sondagem, como uma notificação que expira uma hora depois de ser enviada se você sondar uma atualização a cada meia hora. No caso de um aplicativo de notícias, uma expiração de um dia para um bloco que mostra as principais notícias diárias seria apropriada.

Para notificações periódicas, o tempo de expiração é definido no cabeçalho X-WNS-Expires da mensagem de resposta HTTP da notificação. O tempo de expiração é expresso como uma data HTTP, que usa um dos formatos mostrados nestes exemplos:

  • Dom, 06 Nov 1994 08:49:37 GMT
  • Domingo, 06-Nov-94 08:49:37 GMT
  • Dom Nov 6 08:49:37 1994

Para obter mais informações sobre o formato de data HTTP, consulte o documento Parâmetros de protocolo W3C (World Wide Web Consortium) 3.

Para obter um exemplo de uma implementação completa de notificações periódicas usadas em conjunto com a fila de notificação, consulte Cenário 3 no exemplo de notificações periódicas e push (arquivado).

Confira também

Aplica-se a

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Editar

Inicia uma série de atualizações cronometradas que circulam no bloco ao qual o atualizador está associado. O conteúdo da atualização é recuperado de uma matriz de URI (Uniform Resource Identifier) especificado com atualizações começando em um horário especificado e atualizações subsequentes ocorrendo no intervalo periódico posteriormente.

Observação

Para usar esse recurso, primeiro você deve habilitar a fila de notificação do bloco chamando 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)

Parâmetros

tileContents

IIterable<Uri>

IEnumerable<Uri>

Uma matriz de até cinco URI (Uniform Resource Identifier) da qual o conteúdo XML das atualizações de bloco de ciclismo será recuperado. Se a matriz contiver mais de cinco URI (Uniform Resource Identifier), o método falhará.

startTime
DateTime DateTimeOffset

O momento em que o URI (Uniform Resource Identifier) inicial deve primeiro ser sondado para obter um novo conteúdo.

requestedInterval
PeriodicUpdateRecurrence

A frequência com que o URI (Uniform Resource Identifier) é sondado quanto ao novo conteúdo do bloco, após a atualização inicial em startTime.

Atributos
OverloadAttribute

Comentários

Usando a fila de notificação com atualizações periódicas

Para usar a fila de notificação, primeiro você deve habilitá-la para seu bloco com esta linha de código:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Essa API só precisa ser chamada uma vez no tempo de vida do aplicativo, mas não há nenhum dano em chamá-la sempre que o aplicativo é iniciado.

No caso de notificações periódicas, uma URL exclusiva é fornecida para cada notificação. Cada URL é sondada periodicamente pelo Windows para obter conteúdo de notificação atualizado. A carga de conteúdo retornada de cada URL deve conter versões do XML de notificação para todos os tamanhos de bloco com suporte. Cada URL sondada também pode, opcionalmente, retornar seu próprio tempo de expiração exclusivo e valor de marca.

Marcando notificações para atualizações periódicas

Com a fila de notificação habilitada, o bloco pode percorrer no máximo cinco notificações na fila. Geralmente, a notificação mais antiga é substituída na fila quando uma nova notificação chega. No entanto, as notificações podem receber uma marca para que uma nova notificação com uma marca específica substitua uma notificação mais antiga pela mesma marca, independentemente de seu local na fila.

As marcas são cadeias de caracteres opcionais de até 16 caracteres que podem ser definidas em uma notificação como um identificador. Se uma nova notificação chegar com a mesma marca que uma notificação já na fila, a nova notificação substituirá a antiga em vez de ficar abaixo do comportamento padrão da fila inicial e inicial. Isso impede o caso em que duas versões da mesma notificação, uma delas desatualizada, estejam presentes na fila ao mesmo tempo.

No caso de notificações periódicas, as marcas são fornecidas no cabeçalho X-WNS-Tag da mensagem de resposta HTTP da notificação, que também inclui o conteúdo da notificação. Essa mensagem é enviada em resposta à chamada periódica do sistema para o URI (Uniform Resource Identifier) da notificação. O nome do cabeçalho e o valor da marca não diferenciam maiúsculas de minúsculas.

Um exemplo é mostrado aqui:

X-WNS-Tag: stockMSFT

Definindo um tempo de expiração para atualizações periódicas

Os blocos expiram por padrão após três dias. Se o conteúdo da notificação tiver um tempo de vida útil significativamente diferente, menor ou mais longo, você deverá definir explicitamente um tempo de expiração para cada notificação. Isso impede que conteúdo obsoleto ou irrelevante permaneça na fila. Isso é especialmente importante se o computador do usuário perder a conectividade com a Internet por um longo período de tempo.

Por exemplo, durante a negociação ativa, seria aconselhável que um aplicativo de ações definisse a expiração de uma notificação de preço das ações para o dobro do intervalo de sondagem, como uma notificação que expira uma hora depois de ser enviada se você sondar uma atualização a cada meia hora. No caso de um aplicativo de notícias, uma expiração de um dia para um bloco que mostra as principais notícias diárias seria apropriada.

Para notificações periódicas, o tempo de expiração é definido no cabeçalho X-WNS-Expires da mensagem de resposta HTTP da notificação. O tempo de expiração é expresso como uma data HTTP, que usa um dos formatos mostrados nestes exemplos:

  • Dom, 06 Nov 1994 08:49:37 GMT
  • Domingo, 06-Nov-94 08:49:37 GMT
  • Dom Nov 6 08:49:37 1994

Para obter mais informações sobre o formato de data HTTP, consulte o documento Parâmetros de protocolo W3C (World Wide Web Consortium) 3.

Para obter um exemplo de uma implementação completa de notificações periódicas usadas em conjunto com a fila de notificação, consulte Cenário 3 no exemplo de notificações periódicas e push (arquivado).

Confira também

Aplica-se a