BitmapDecoder.Create Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria um BitmapDecoder usando o especificado BitmapCreateOptions e BitmapCacheOption.
Sobrecargas
| Name | Description |
|---|---|
| Create(Stream, BitmapCreateOptions, BitmapCacheOption) |
Cria um BitmapDecoder a partir de a Stream usando o especificado BitmapCreateOptions e BitmapCacheOption. |
| Create(Uri, BitmapCreateOptions, BitmapCacheOption) |
Cria um BitmapDecoder a partir de a Uri usando o especificado BitmapCreateOptions e BitmapCacheOption. |
| Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) |
Cria a BitmapDecoder a partir de a Uri usando o especificado BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy. |
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
- 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.