BitmapDecoder.Create Metodo

Definizione

Crea un BitmapDecoder oggetto utilizzando l'oggetto specificato BitmapCreateOptions e BitmapCacheOption.

Overload

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea un oggetto BitmapDecoder da un Stream oggetto utilizzando l'oggetto specificato 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

Parametri

bitmapStream
Stream

Flusso di file che identifica la bitmap da decodificare.

createOptions
BitmapCreateOptions

Identifica l'oggetto BitmapCreateOptions per questo decodificatore.

cacheOption
BitmapCacheOption

Identifica l'oggetto BitmapCacheOption per questo decodificatore.

Valori restituiti

Oggetto BitmapDecoder da un Stream oggetto utilizzando l'oggetto specificato BitmapCreateOptions e BitmapCacheOption.

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo per creare un decodificatore per una determinata immagine. Il primo BitmapFrame dell'immagine viene usato come origine di un Image controllo.

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)

Commenti

Usare l'opzione OnLoad cache se si desidera chiudere il bitmapStream dopo la creazione del decodificatore. L'opzione cache predefinita OnDemand mantiene l'accesso al flusso fino a quando non è necessaria la bitmap e la pulizia viene gestita dal Garbage Collector.

Vedi anche

Si applica a

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crea un oggetto BitmapDecoder da un Uri oggetto utilizzando l'oggetto specificato 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

Parametri

bitmapUri
Uri

Oggetto Uri della bitmap da decodificare.

createOptions
BitmapCreateOptions

Identifica l'oggetto BitmapCreateOptions per questo decodificatore.

cacheOption
BitmapCacheOption

Identifica l'oggetto BitmapCacheOption per questo decodificatore.

Valori restituiti

Oggetto BitmapDecoder da un Uri oggetto utilizzando l'oggetto specificato BitmapCreateOptions e BitmapCacheOption.

Eccezioni

Il bitmapUri è null.

bitmapUri Specifica un ID classe di un tipo di formato non supportato.

Esempio

Nell'esempio seguente viene illustrato come usare il Create(Uri, BitmapCreateOptions, BitmapCacheOption) metodo per creare un decodificatore per una determinata immagine. Il primo BitmapFrame dell'immagine viene usato come origine di un Image controllo.

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)

Vedi anche

Si applica a

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crea un oggetto BitmapDecoder da un Uri oggetto utilizzando l'oggetto specificato BitmapCreateOptionsBitmapCacheOption 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

Parametri

bitmapUri
Uri

Posizione della bitmap da cui viene creato l'oggetto BitmapDecoder .

createOptions
BitmapCreateOptions

Opzioni utilizzate per creare questo BitmapDecoderoggetto .

cacheOption
BitmapCacheOption

Opzione della cache utilizzata per creare questo BitmapDecoderoggetto .

uriCachePolicy
RequestCachePolicy

Requisiti di memorizzazione nella cache per questo BitmapDecoderoggetto .

Valori restituiti

Oggetto BitmapDecoder da un Uri oggetto utilizzando l'oggetto specificato BitmapCreateOptionsBitmapCacheOption e RequestCachePolicy.

Commenti

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) è stato introdotto in .NET Framework versione 3.5.

Si applica a