ContentPrefetcher Classe

Definição

public ref class ContentPrefetcher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ContentPrefetcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ContentPrefetcher

Public Class ContentPrefetcher

Herança

Object Platform::Object IInspectable ContentPrefetcher

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Comentários

Muitas categorias de aplicativos precisam baixar quantidades significativas de conteúdo da Web após a inicialização. Isso pode resultar em experiências ruins do usuário em que os usuários devem esperar o conteúdo ser carregado antes que o aplicativo se torne totalmente funcional. A classe ContentPrefetcher fornece mecanismos para especificar recursos que o Windows deve tentar baixar antes de seu aplicativo ser iniciado pelo usuário.

A heurística é usada para determinar quando a pré-busca deve ocorrer e quais recursos serão baixados. Essas heurísticas levam em conta as condições de rede e energia do sistema, o histórico de uso do aplicativo de usuário e os resultados de tentativas anteriores de pré-busca para fornecer o máximo benefício do usuário, mas não há nenhuma garantia de que qualquer recurso específico terá sido baixado antes de uma determinada inicialização de aplicativo.

Os recursos que foram pré-buscados com êxito serão colocados no cache WinINet específico do aplicativo. Nenhuma alteração é necessária para solicitações HTTP existentes para esses recursos depois que o aplicativo estiver em execução; O WinINet simplesmente fornecerá de forma transparente o conteúdo do cache se ele estiver disponível. Caso um recurso solicitado não tenha sido pré-buscado, uma solicitação HTTP para conteúdo simplesmente resultará em uma falha de cache e a solicitação será feita ao servidor. Observe que essa estratégia de cache funciona para solicitações HTTP feitas usando a interface WinJS.xhr, Windows.Web.Http.HttpClient e IXMLHTTPRequest2 . Não há suporte para o HttpClient .NET Framework.

A classe ContentPrefetcher fornece dois mecanismos para especificar recursos que devem ser pré-buscados:

• A propriedade ContentUris permite que a especificação direta do lado do cliente dos recursos seja pré-buscada. Isso é útil para conteúdo com URIs que são bastante estáticos, pois não são alterados entre o uso subsequente do aplicativo. Um exemplo seria os URIs associados a seções de um aplicativo ao qual um usuário está inscrito, o que só seria alterado quando o usuário atualizasse suas opções de assinatura com o aplicativo.
• A propriedade IndirectContentUri fornece para especificar o local de um arquivo XML que lista os recursos a serem pré-buscados. Os recursos a serem pré-buscados podem ser atualizados dinamicamente modificando o conteúdo do XML. Isso é útil nos casos em que o conteúdo é mais dinâmico, na qual os URIs de conteúdo devem ser alterados entre o uso subsequente do aplicativo.

Um exemplo seria pré-busca de imagens para os artigos de notícias mais recentes, os artigos de notícias e as imagens correspondentes mudam com frequência e o arquivo XML pode ser mantido atualizado com as URIs mais recentes para pré-busca. Os aplicativos podem usar ambas as propriedades para especificar recursos para pré-busca. Observe que há suporte para no máximo 40 URIs de conteúdo e os recursos especificados por meio da propriedade ContentUri serão baixados em preferência àqueles especificados pelo XML IndirectContentUri . Você deve priorizar o conteúdo de pré-busca que um usuário vê pela primeira vez ou que um usuário usa com frequência para obter o maior benefício da operação de pré-busca. Você deve indicar o conteúdo que tem um tempo de vida razoavelmente longo para seu aplicativo. Não pré-busca conteúdo que tenha um tempo de expiração imediato ou muito curto ou conteúdo que seria desativado da exibição de um usuário em um curto período de tempo. O conteúdo de curta duração é uma opção ruim para conteúdo pré-buscado, pois é provável que o conteúdo expire ou não seja exibido antes que o aplicativo seja usado e, portanto, não seja um benefício para os usuários.

Conforme mencionado acima, o sistema determina quando a pré-busca é executada para um aplicativo. No entanto, para fins de desenvolvimento, você pode iniciar a pré-busca imediata para seu aplicativo chamando a API da área de trabalho da interface IContentPrefetcherTaskTrigger .

Para ajudar na depuração, você pode escutar eventos ETW no canal Microsoft-Windows-BackgroundTransfer-ContentPrefetcher . Ocorrências como iniciação e conclusão de pré-busca, iniciação e conclusão de uma solicitação HTTP e validação XML dispararão eventos.

Propriedades

Aplica-se a