BitmapDecoder.Create Methode

Definition

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Erstellt einen BitmapDecoder mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption.

Überlädt

Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Erstellt mithilfe der angegebenen BitmapDecoder und Stream einen BitmapCreateOptions aus einem BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Erstellt mithilfe der angegebenen BitmapDecoder und Uri einen BitmapCreateOptions aus einem BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Erstellt mithilfe der angegebenen BitmapDecoder, der angegebenen Uri und der angegebenen BitmapCreateOptions einen BitmapCacheOption aus einem RequestCachePolicy.

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Erstellt mithilfe der angegebenen BitmapDecoder und Stream einen BitmapCreateOptions aus einem 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

Parameter

bitmapStream

Stream

Der Dateistream, der die zu decodierende Bitmap identifiziert.

createOptions

BitmapCreateOptions

Bezeichnet die BitmapCreateOptions für diesen Decoder.

cacheOption

BitmapCacheOption

Bezeichnet die BitmapCacheOption für diesen Decoder.

Gibt zurück

BitmapDecoder

Ein BitmapDecoder aus einem Stream mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Create Methode zum Erstellen eines Decoders für ein bestimmtes Bild verwenden. Das erste BitmapFrame Bild wird als Quelle eines Image Steuerelements verwendet.

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)

Hinweise

Verwenden Sie die OnLoad Cacheoption, wenn Sie den bitmapStream Decoder schließen möchten. Die Standardcacheoption OnDemand behält Zugriff auf den Datenstrom, bis die Bitmap benötigt wird, und die Bereinigung wird vom Garbage Collector behandelt.

Siehe auch

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Erstellt mithilfe der angegebenen BitmapDecoder und Uri einen BitmapCreateOptions aus einem 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

Parameter

bitmapUri

Uri

Der Uri der zu decodierenden Bitmap.

createOptions

BitmapCreateOptions

Bezeichnet die BitmapCreateOptions für diesen Decoder.

cacheOption

BitmapCacheOption

Bezeichnet die BitmapCacheOption für diesen Decoder.

Gibt zurück

BitmapDecoder

Ein BitmapDecoder aus einem Uri mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption.

Ausnahmen

ArgumentNullException

bitmapUri ist null.

FileFormatException

Der bitmapUri gibt eine Klassen-ID eines nicht unterstützten Formattyps an.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Create(Uri, BitmapCreateOptions, BitmapCacheOption) Methode zum Erstellen eines Decoders für ein bestimmtes Bild verwenden. Das erste BitmapFrame Bild wird als Quelle eines Image Steuerelements verwendet.

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)

Siehe auch

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Erstellt mithilfe der angegebenen BitmapDecoder, der angegebenen Uri und der angegebenen BitmapCreateOptions einen BitmapCacheOption aus einem 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

Parameter

bitmapUri

Uri

Der Speicherort der Bitmap, anhand derer der BitmapDecoder erstellt wird.

createOptions

BitmapCreateOptions

Die Optionen, die zum Erstellen des BitmapDecoder verwendet werden.

cacheOption

BitmapCacheOption

Die zum Erstellen des BitmapDecoder verwendete Zwischenspeicherungsoption.

uriCachePolicy

RequestCachePolicy

Die Zwischenspeicheranforderungen für diesen BitmapDecoder.

Gibt zurück

BitmapDecoder

Ein BitmapDecoder aus einem Uri mithilfe der angegebenen BitmapCreateOptions, BitmapCacheOption und RequestCachePolicy.

Hinweise

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)wird in der .NET Framework Version 3.5 eingeführt.