Windows Dev Center

Idioma: HTML | XAML

Como carregar recursos de arquivos (XAML)

Aprenda a carregar recursos de arquivos de vários locais.

É possível acessar os recursos dos arquivos do aplicativo que você oferece como parte do pacote do aplicativo, ou inclui como parte de um componente ou pacote de estrutura, de dados do aplicativo ou da Web. Você pode fazer referência a esses arquivos na marcação (atributos XAML ou XML de Notificações) ou através do código (como Windows.Web.Http ou storage file APIs). Os exemplos aqui mostram os recursos de arquivo em contextos específicos, mas você pode usar a maioria deles em vários outros contextos.

Web

Para acessar arquivos da Web em XAML, você pode usar URIs HTTP absolutos padrão.


<Image Source="http://www.contoso.com/images/logo.png" alt="Logo" />

Pacote do aplicativo

Para acessar arquivos de seu pacote de aplicativo, você pode usar um caminho de arquivo lógico ou direto para mencionar o recurso. Isso vale mesmo quando os arquivos têm vários idiomas, escalas, contrastes ou outras variações. Veja Guia de início rápido: usando recursos de arquivo ou imagens para uma introdução.

Por exemplo, carregue

Images/en-US/homeregion-USA/logo.scale-100_contrast-white.png

mencionando

Images/logo.png

Para acessar arquivos relativos à página XAML atual, você pode usar URIs relativos.


<Image Source="images/logo.png" />

Para acessar arquivos relativos à raiz do pacote, em uma página XAML, você pode usar URIs de caminho absolutos (aqueles que começam com "/").

<Image Source="/images/logo.png" />

Para acessar arquivos armazenados dentro do pacote do aplicativo, mas de código em que não há nenhuma autoridade raiz inferida, especifique o esquema ms-appx:.



var uri = new System.Uri("ms-appx:///images/logo.png");
var file = await Windows.Storage.StorageFile.GetFileFromApplicationUriAsync(uri);

As APIs do Tempo de Execução do Windows não dão suporte a URIs do tipo UriKind.Relative; então você geralmente usa a assinatura que infere o UriKind e verifica se especificou um URI absoluto válido, incluindo o esquema e a autoridade.

Dados do aplicativo

Para acessar arquivos armazenados nos dados do aplicativo, use o esquema ms-appdata:. Os dados do aplicativo podem ser armazenados em uma pasta local, roaming ou temp.

Para acessar arquivos armazenados na pasta local:

<Image Source="ms-appdata:///local/images/logo.png" />

Para acessar arquivos armazenados na pasta em roaming:

<Image Source="ms-appdata:///roaming/images/logo.png" />

Para acessar arquivos armazenados na pasta temporária:

<Image Source="ms-appdata:///temp/images/logo.png" />

As storage file APIs podem acessar arquivos dentro do pacote do aplicativo do mesmo modo:



var uri = new System.Uri("ms-appdata:///local/images/logo.png");
var file = await Windows.Storage.StorageFile.GetFileFromApplicationUriAsync(uri);

Mudanças de eventos e contexto

Os aplicativos ainda poderão estar em execução quando o sistema for alterado, como quando o usuário ativa o alto contraste. O resultado é que o aplicativo usa um conjunto de qualificadores diferente. Diversas alterações do sistema invocarão eventos no objeto ResourceContext, e os recursos poderão ser reavaliados, dependendo das implementações das classes do Tempo de Execução do Windows que o seu aplicativo usa.

O XAML também tem um conceito relacionado de um ThemeResource. Essa é uma metáfora de recurso diferente, onde tipos de valores relacionados à interface do usuário, como pincéis, texto e medidas, que possam ser definidos como compartilháveis no XAML automaticamente alternarão valores e reavaliarão quando o usuário alternar temas. Para saber mais, veja Referências de recursos de ResourceDictionary e XAML.

Tópicos relacionados

Como carregar recursos de cadeias de caracteres
Definindo recursos do aplicativo

 

 

Mostrar:
© 2015 Microsoft