Compartir a través de


BitmapDecoder.Create Método

Definición

Crea una clase BitmapDecoder mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

Sobrecargas

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea una clase BitmapDecoder a partir de un Stream mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crea una clase BitmapDecoder a partir de un Uri mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crea un BitmapDecoder a partir de un Uri mediante las BitmapCreateOptions, BitmapCacheOption y RequestCachePolicy especificadas.

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea una clase BitmapDecoder a partir de un Stream mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

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 decodificar.

createOptions
BitmapCreateOptions

Identifica BitmapCreateOptions para este decodificador.

cacheOption
BitmapCacheOption

Identifica BitmapCacheOption para este decodificador.

Devoluciones

Una BitmapDecoder a partir de un Stream mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

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 una bitmapStream vez creado 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 una clase BitmapDecoder a partir de un Uri mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

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 va a descodificarse.

createOptions
BitmapCreateOptions

Identifica BitmapCreateOptions para este decodificador.

cacheOption
BitmapCacheOption

Identifica BitmapCacheOption para este decodificador.

Devoluciones

Una BitmapDecoder a partir de un Uri mediante las enumeraciones BitmapCreateOptions y BitmapCacheOption especificadas.

Excepciones

El valor de bitmapUri es null.

bitmapUri especifica un id. de clase de un tipo de formato no compatible.

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 a partir de un Uri mediante las BitmapCreateOptions, BitmapCacheOption y RequestCachePolicy especificadas.

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 a partir del que se crea el BitmapDecoder.

createOptions
BitmapCreateOptions

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é de este BitmapDecoder.

Devoluciones

Una BitmapDecoder a partir de un Uri mediante las enumeraciones BitmapCreateOptions, BitmapCacheOption y RequestCachePolicy especificadas.

Comentarios

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

Se aplica a