BitmapDecoder.Create Método

Definición

Espacio de nombres:

System.Windows.Media.Imaging

Ensamblado:

PresentationCore.dll

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

BitmapDecoder

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

• BitmapSource

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

BitmapDecoder

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

Excepciones

ArgumentNullException

El valor de bitmapUri es null.

FileFormatException

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

• BitmapSource

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

BitmapDecoder

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.