BitmapDecoder.Create Método

Definição

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

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

• BitmapSource

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

ArgumentNullException

O bitmapUri é null.

FileFormatException

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

• BitmapSource

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.