BitmapDecoder.Create Método

Definición

Crea un BitmapDecoder mediante el especificado BitmapCreateOptions y BitmapCacheOption.

Sobrecargas

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea un BitmapDecoder objeto a partir de mediante Stream el especificado BitmapCreateOptions y 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

Secuencia de archivos que identifica el mapa de bits que se va a descodificar.

createOptions
BitmapCreateOptions

Identifica para BitmapCreateOptions este descodificador.

cacheOption
BitmapCacheOption

Identifica para BitmapCacheOption este descodificador.

Devoluciones

BitmapDecoder de un Stream mediante el especificado BitmapCreateOptions y BitmapCacheOption.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Create método para crear un descodificador para una imagen determinada. La primera BitmapFrame de la imagen se usa como origen de un Image control.

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)

Comentarios

Use la OnLoad opción de caché si desea cerrar bitmapStream después de crear el descodificador. La opción de caché predeterminada OnDemand conserva el acceso a la secuencia hasta que se necesita el mapa de bits y el recolector de elementos no utilizados controla la limpieza.

Consulte también

Se aplica a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crea un BitmapDecoder objeto a partir de mediante Uri el especificado BitmapCreateOptions y 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

Uri del mapa de bits que se va a descodificar.

createOptions
BitmapCreateOptions

Identifica para BitmapCreateOptions este descodificador.

cacheOption
BitmapCacheOption

Identifica para BitmapCacheOption este descodificador.

Devoluciones

BitmapDecoder de un Uri mediante el especificado BitmapCreateOptions y BitmapCacheOption.

Excepciones

El bitmapUri es null.

bitmapUri especifica un identificador de clase de un tipo de formato no admitido.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Create(Uri, BitmapCreateOptions, BitmapCacheOption) método para crear un descodificador para una imagen determinada. La primera BitmapFrame de la imagen se usa como origen de un Image control.

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)

Consulte también

Se aplica a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crea un BitmapDecoder objeto a partir de mediante Uri el objeto especificado BitmapCreateOptionsy BitmapCacheOptionRequestCachePolicy.

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

Ubicación del mapa de bits desde el que se crea .BitmapDecoder

createOptions
BitmapCreateOptions

Las opciones que se usan para crear este BitmapDecoder.

cacheOption
BitmapCacheOption

Opción de caché que se usa para crear este BitmapDecoder.

uriCachePolicy
RequestCachePolicy

Requisitos de almacenamiento en caché para este BitmapDecoder.

Devoluciones

BitmapDecoder de un Uri mediante el especificado BitmapCreateOptionsy BitmapCacheOptionRequestCachePolicy.

Comentarios

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) se introduce en la versión 3.5 de .NET Framework.

Se aplica a