BitmapImage.CreateOptions Propriedade

Definição

Namespace:

Windows.UI.Xaml.Media.Imaging

Obtém ou define o BitmapCreateOptions para um BitmapImage.

public:
 property BitmapCreateOptions CreateOptions { BitmapCreateOptions get(); void set(BitmapCreateOptions value); };

BitmapCreateOptions CreateOptions();

void CreateOptions(BitmapCreateOptions value);

public BitmapCreateOptions CreateOptions { get; set; }

var bitmapCreateOptions = bitmapImage.createOptions;
bitmapImage.createOptions = bitmapCreateOptions;

Public Property CreateOptions As BitmapCreateOptions

<BitmapImage CreateOptions="bitmapCreateOptionsMemberName"/>

Valor da propriedade

BitmapCreateOptions

O BitmapCreateOptions usado para este BitmapImage. O padrão é Nenhum. Com esse padrão, um BitmapImage usa conteúdo armazenado em cache quando está disponível. Para um BitmapImage criado fazendo referência a um arquivo de origem de imagem pelo URI (Uniform Resource Identifier), o URI (Uniform Resource Identifier) controla o esquema de cache interno.

Comentários

O outro valor possível para CreateOptions é BitmapCreateOptions.IgnoreImageCache. Você só deve usar BitmapCreateOptions.IgnoreImageCache nos casos em que você sabe que o arquivo de imagem de origem, conforme recuperado pelo URI (Uniform Resource Identifier), tem o potencial de alterar ao longo do tempo. Caso contrário, definir CreateOptions para usar BitmapCreateOptions.IgnoreImageCache faz com que todas as fontes de imagem recém-recuperadas sejam decodificadas novamente, o que pode afetar negativamente o desempenho. BitmapCreateOptions.IgnoreImageCache normalmente só é usado por ferramentas de design que manipulam diretamente uma imagem em um local de arquivo e precisam impor que qualquer conteúdo determinado por URI seja sempre recarregado do local, não do cache.