Compartilhar via


BitmapDecoder.Create Método

Definição

Cria um BitmapDecoder usando os BitmapCreateOptions e BitmapCacheOption especificados.

Sobrecargas

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder de um Stream usando o BitmapCreateOptions e o BitmapCacheOption especificados.

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder de um Uri usando o BitmapCreateOptions e o BitmapCacheOption especificados.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Cria um BitmapDecoder de um Uri usando o BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder de um Stream usando o BitmapCreateOptions e o BitmapCacheOption especificados.

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 para este decodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption para este decodificador.

Retornos

BitmapDecoder

Um BitmapDecoder de um Stream usando o BitmapCreateOptions e o BitmapCacheOption especificados.

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 manipulada pelo coletor de lixo.

Confira também

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder de um Uri usando o BitmapCreateOptions e o BitmapCacheOption especificados.

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 do bitmap a ser decodificado.

createOptions
BitmapCreateOptions

Identifica o BitmapCreateOptions para este decodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption para este decodificador.

Retornos

BitmapDecoder

Um BitmapDecoder de um Uri usando o BitmapCreateOptions e o BitmapCacheOption especificados.

Exceções

O bitmapUri é null.

O bitmapUri especifica 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)

Cria um BitmapDecoder de um Uri usando o BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.

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 é criado.

createOptions
BitmapCreateOptions

As opções usadas para criar este BitmapDecoder.

cacheOption
BitmapCacheOption

As opção de cache usada para criar este BitmapDecoder.

uriCachePolicy
RequestCachePolicy

Os requisitos de cache para este BitmapDecoder.

Retornos

BitmapDecoder

Um BitmapDecoder de um Uri usando o BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy especificados.

Comentários

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

Aplica-se a