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 a 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 ficheiros que identifica o bitmap a decodificar.

createOptions
BitmapCreateOptions

Identifica o BitmapCreateOptions para este descodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption para este descodificador.

Devoluções

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

Exemplos

O exemplo seguinte demonstra como usar o Create método para criar um descodificador para uma dada imagem. A primeira BitmapFrame parte da imagem é usada como fonte de controlo Image .

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)

Observações

Use a opção de OnLoad cache se quiser fechar depois bitmapStream de criar o descodificador. A opção de cache por defeito OnDemand mantém o acesso ao fluxo até ser necessário o bitmap, e a limpeza é tratada pelo coletor de lixo.

Ver também

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder a partir de a 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 do bitmap para decodificar.

createOptions
BitmapCreateOptions

Identifica o BitmapCreateOptions para este descodificador.

cacheOption
BitmapCacheOption

Identifica o BitmapCacheOption para este descodificador.

Devoluções

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

Exceções

O bitmapUri é null.

Especifica bitmapUri um ID de classe de um tipo de formato não suportado.

Exemplos

O exemplo seguinte demonstra como usar o Create(Uri, BitmapCreateOptions, BitmapCacheOption) método para criar um descodificador para uma dada imagem. A primeira BitmapFrame parte da imagem é usada como fonte de controlo Image .

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)

Ver também

Aplica-se a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Cria a BitmapDecoder a partir de a Uri usando o especificado BitmapCreateOptions, BitmapCacheOption e 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

A localização do bitmap a partir do qual o BitmapDecoder é criado.

createOptions
BitmapCreateOptions

As opções que são usadas para criar isto BitmapDecoder.

cacheOption
BitmapCacheOption

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

uriCachePolicy
RequestCachePolicy

Os requisitos de cache para este BitmapDecoder.

Devoluções

A BitmapDecoder de a Uri usando o especificado BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy.

Observações

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

Aplica-se a