BitmapDecoder.Create Método

Definição

Cria um BitmapDecoder usando o especificado BitmapCreateOptions e BitmapCacheOption.

Sobrecargas

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder a partir de um Stream usando o especificado BitmapCreateOptions e BitmapCacheOption.

public:
 static System::Windows::Media::Imaging::BitmapDecoder ^ Create(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
public static System.Windows.Media.Imaging.BitmapDecoder Create(System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
static member Create : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapDecoder
Public Shared Function Create (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapDecoder

Parâmetros

bitmapStream
Stream

O fluxo de arquivos que identifica o bitmap a ser decodificado.

createOptions
BitmapCreateOptions

Identifica o BitmapCreateOptions decodificador para esse decodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption decodificador para esse decodificador.

Retornos

A BitmapDecoder de um Stream usando o especificado BitmapCreateOptions e BitmapCacheOption.

Exemplos

O exemplo a seguir demonstra como usar o Create método para criar um decodificador para uma determinada imagem. O primeiro BitmapFrame da imagem é usado como a origem de um Image controle.

Stream imageStream = new FileStream("sampleImages/waterlilies.jpg",
   FileMode.Open, FileAccess.Read, FileShare.Read);

BitmapDecoder streamBitmap = BitmapDecoder.Create(
   imageStream, BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image streamImage = new Image();
streamImage.Width = 200;
// Set image source using the first frame.
streamImage.Source = streamBitmap.Frames[0];
Dim imageStream As FileStream = New FileStream("sampleImages/waterlilies.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)

Dim streamBitmap As BitmapDecoder = BitmapDecoder.Create(imageStream, BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim streamImage As New Image()
streamImage.Width = 200
' Set image source using the first frame.
streamImage.Source = streamBitmap.Frames(0)

Comentários

Use a opção OnLoad de cache se desejar fechar depois bitmapStream que o decodificador for criado. A opção de cache padrão OnDemand mantém o acesso ao fluxo até que o bitmap seja necessário e a limpeza seja tratada pelo coletor de lixo.

Confira também

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder a partir de um Uri usando o especificado BitmapCreateOptions e BitmapCacheOption.

public:
 static System::Windows::Media::Imaging::BitmapDecoder ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
public static System.Windows.Media.Imaging.BitmapDecoder Create(Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapDecoder
Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapDecoder

Parâmetros

bitmapUri
Uri

O Uri bitmap a ser decodificado.

createOptions
BitmapCreateOptions

Identifica o BitmapCreateOptions decodificador para esse decodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption decodificador para esse decodificador.

Retornos

A BitmapDecoder de um Uri usando o especificado BitmapCreateOptions e BitmapCacheOption.

Exceções

O bitmapUri é null.

Especifica bitmapUri uma ID de classe de um tipo de formato sem suporte.

Exemplos

O exemplo a seguir demonstra como usar o Create(Uri, BitmapCreateOptions, BitmapCacheOption) método para criar um decodificador para uma determinada imagem. O primeiro BitmapFrame da imagem é usado como a origem de um Image controle.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];
Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

Confira também

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

public:
 static System::Windows::Media::Imaging::BitmapDecoder ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);
public static System.Windows.Media.Imaging.BitmapDecoder Create(Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption, System.Net.Cache.RequestCachePolicy uriCachePolicy);
static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapDecoder
Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption, uriCachePolicy As RequestCachePolicy) As BitmapDecoder

Parâmetros

bitmapUri
Uri

O local do bitmap do qual o BitmapDecoder bitmap é criado.

createOptions
BitmapCreateOptions

As opções usadas para criar isso BitmapDecoder.

cacheOption
BitmapCacheOption

A opção de cache usada para criar isso BitmapDecoder.

uriCachePolicy
RequestCachePolicy

Os requisitos de cache para isso BitmapDecoder.

Retornos

A BitmapDecoder de um Uri usando o especificado BitmapCreateOptionse BitmapCacheOptionRequestCachePolicy.

Comentários

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) é introduzido no .NET Framework versão 3.5.

Aplica-se a