BitmapCacheOption Enumeração
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.
Especifica como uma imagem de bitmap se beneficia do cache de memória.
public enum class BitmapCacheOptionpublic enum BitmapCacheOptiontype BitmapCacheOption = Public Enum BitmapCacheOption- Herança
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)
