BitmapCacheOption Enumeração

Definição

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Especifica como uma imagem de bitmap se beneficia do cache de memória.

public enum class BitmapCacheOption

public enum BitmapCacheOption

type BitmapCacheOption = 

Public Enum BitmapCacheOption

Herança

Object

ValueType

Enum

BitmapCacheOption

Campos

Default	0	Armazena em cache toda a imagem na memória. Este é o valor padrão.
None	2	Não crie um repositório em memória. Todas as solicitações de imagem são preenchidas diretamente pelo arquivo de imagem.
OnDemand	0	Cria um repositório em memória apenas para os dados solicitados. A primeira solicitação carrega a imagem diretamente; as solicitações subsequentes são preenchidas no cache.
OnLoad	1	Armazena a imagem inteira na memória no tempo de carregamento. Todas as solicitações de dados de imagem são preenchidas no repositório em memória.

Exemplos

O exemplo de código a seguir demonstra como carregar um BitmapImage e especificar o BitmapCacheOption.

// Define a BitmapImage.
Image myImage = new Image();
BitmapImage bi = new BitmapImage();

// Begin initialization.
bi.BeginInit();

// Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand;
bi.CreateOptions = BitmapCreateOptions.DelayCreation;
bi.DecodePixelHeight = 125;
bi.DecodePixelWidth = 125;
bi.Rotation = Rotation.Rotate90;
MessageBox.Show(bi.IsDownloading.ToString());
bi.UriSource = new Uri("smiley.png", UriKind.Relative);

// End initialization.
bi.EndInit();
myImage.Source = bi;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(5);

' Define a BitmapImage.
Dim myImage As New Image()
Dim bi As New BitmapImage()

' Begin initialization.
bi.BeginInit()

' Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand
bi.CreateOptions = BitmapCreateOptions.DelayCreation
bi.DecodePixelHeight = 125
bi.DecodePixelWidth = 125
bi.Rotation = Rotation.Rotate90
MessageBox.Show(bi.IsDownloading.ToString())
bi.UriSource = New Uri("smiley.png", UriKind.Relative)

' End initialization.
bi.EndInit()
myImage.Source = bi
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(5)

Confira também

• BitmapCreateOptions