BitmapImage.UriSource Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o URI (Uniform Resource Identifier) do arquivo de origem gráfico que gerou esse BitmapImage.
public:
property Uri ^ UriSource { Uri ^ get(); void set(Uri ^ value); };
Uri UriSource();
void UriSource(Uri value);
public System.Uri UriSource { get; set; }
var uri = bitmapImage.uriSource;
bitmapImage.uriSource = uri;
Public Property UriSource As Uri
<BitmapImage UriSource="uri" />
Valor da propriedade
Um objeto que descreve o URI (Uniform Resource Identifier) do arquivo de origem gráfico que gerou esse BitmapImage.
Comentários
A propriedade BaseUri poderá ser útil para formar o URI se você estiver aplicando um arquivo de origem de imagem a um elemento Image específico.
Em situações de memória baixa (provavelmente em telefones com memória inferior), é possível que uma exceção seja gerada com a mensagem "A imagem não é reconhecida" e um HRESULT de 0x88982F60. Embora essa exceção normalmente indique dados inválidos, se o aplicativo estiver próximo do limite de memória, a causa da exceção provavelmente será pouca memória. Nesse caso, recomendamos que você libere a memória e tente novamente.
Observações para versões anteriores
Windows 8
Windows 8 tinha lógica de validação de URI associada ao setter dessa propriedade. Começando com Windows 8.1 que a validação no setter de propriedade é removida. Isso não significa que você não obtenha nenhuma validação, isso significa que você obtém a mesma validação final que você deve usar de qualquer maneira: manipulação para eventos ImageOpened ou ImageFailed na Imagem em que a origem é aplicada.
Os aplicativos que foram compilados para Windows 8 mas em execução no Windows 8.1 usam o novo comportamento de Windows 8.1.