BitmapDecoder.Create Metodo

Definizione

Spazio dei nomi:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Crea un oggetto BitmapDecoder utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.

Overload

Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Crea un oggetto BitmapDecoder da un Stream utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Crea un oggetto BitmapDecoder da un Uri utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Crea un oggetto BitmapDecoder da un Uri utilizzando gli oggetti BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy specificati.

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Crea un oggetto BitmapDecoder da un Stream utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.

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.

Restituisce

BitmapDecoder

Oggetto BitmapDecoder da un oggetto Stream utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo per creare un decodificatore per un'immagine specificata. 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 decodificatore dopo la creazione del decodificatore. L'opzione cache predefinita OnDemand mantiene l'accesso al flusso finché non è necessaria la bitmap e la pulizia viene gestita dal Garbage Collector.

Vedi anche

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Crea un oggetto BitmapDecoder da un Uri utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.

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

Uri della bitmap da decodificare.

createOptions

BitmapCreateOptions

Identifica l'oggetto BitmapCreateOptions per questo decodificatore.

cacheOption

BitmapCacheOption

Identifica l'oggetto BitmapCacheOption per questo decodificatore.

Restituisce

BitmapDecoder

Oggetto BitmapDecoder da un oggetto Uri utilizzando gli oggetti BitmapCreateOptions e BitmapCacheOption specificati.

Eccezioni

ArgumentNullException

L'elemento bitmapUri è null.

FileFormatException

L'oggetto bitmapUri specifica un ID di classe per 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 un'immagine specificata. 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

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Crea un oggetto BitmapDecoder da un Uri utilizzando gli oggetti BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy specificati.

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

Percorso della bitmap dal quale viene creato l'oggetto BitmapDecoder.

createOptions

BitmapCreateOptions

Opzioni utilizzate per creare l'oggetto BitmapDecoder.

cacheOption

BitmapCacheOption

Opzione di memorizzazione nella cache utilizzata per creare l'oggetto BitmapDecoder.

uriCachePolicy

RequestCachePolicy

I requisiti della memorizzazione nella cache per l'oggetto BitmapDecoder.

Restituisce

BitmapDecoder

Oggetto BitmapDecoder da un oggetto Uri utilizzando gli oggetti BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy specificati.

Commenti

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)viene introdotto nella .NET Framework versione 3.5.