BmpBitmapDecoder Konstruktoren

Definition

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Initialisiert eine neue Instanz von BmpBitmapDecoder.

Überlädt

BmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	Initialisiert eine neue Instanz von BmpBitmapDecoder aus dem angegebenen Dateistream mit den angegebenen createOptions und der angegebenen cacheOption.
BmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	Initialisiert eine neue Instanz von BmpBitmapDecoder aus dem angegebenen Uri mit den angegebenen createOptions und der angegebenen cacheOption.

BmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

Initialisiert eine neue Instanz von BmpBitmapDecoder aus dem angegebenen Dateistream mit den angegebenen createOptions und der angegebenen cacheOption.

public:
 BmpBitmapDecoder(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public BmpBitmapDecoder (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

new System.Windows.Media.Imaging.BmpBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BmpBitmapDecoder

Public Sub New (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Parameter

bitmapStream

Stream

Der zu decodierende Bitmapstream.

createOptions

BitmapCreateOptions

Initialisierungsoptionen für das Bitmap-Bild.

cacheOption

BitmapCacheOption

Die Zwischenspeicherungsmethode, die für das Bitmap-Bild verwendet werden soll.

Ausnahmen

ArgumentNullException

Der bitmapStream-Wert ist null.

FileFormatException

Das bitmapStream ist kein Bitmap-codiertes Bild (BMP).

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz von erstellt und aus einem Dateistream verwendet wird BmpBitmapDecoder . Das decodierte Bild wird als Quelle eines Steuerelements Image verwendet.

// Open a Stream and decode a BMP image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.bmp", FileMode::Open, FileAccess::Read, FileShare::Read);
BmpBitmapDecoder^ decoder = gcnew BmpBitmapDecoder(imageStreamSource, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource = decoder->Frames[0];

// Draw the Image
Image^ myImage = gcnew Image();
myImage->Source = bitmapSource;
myImage->Stretch = Stretch::None;
myImage->Margin = System::Windows::Thickness(20);

// Open a Stream and decode a BMP image
Stream imageStreamSource = new FileStream("tulipfarm.bmp", FileMode.Open, FileAccess.Read, FileShare.Read);
BmpBitmapDecoder decoder = new BmpBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage = new Image();
myImage.Source = bitmapSource;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(20);

' Open a Stream and decode a BMP image
Dim imageStreamSource As New FileStream("tulipfarm.bmp", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New BmpBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage As New Image()
myImage.Source = bitmapSource
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(20)

Hinweise

Verwenden Sie die OnLoad Cacheoption, wenn Sie den bitmapStream schließen möchten, nachdem der Decoder erstellt wurde. Die Standardcacheoption OnDemand behält den Zugriff auf den Stream bei, bis die Bitmap benötigt wird und die Bereinigung vom Garbage Collector verarbeitet wird.

BmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

Initialisiert eine neue Instanz von BmpBitmapDecoder aus dem angegebenen Uri mit den angegebenen createOptions und der angegebenen cacheOption.

public:
 BmpBitmapDecoder(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public BmpBitmapDecoder (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

new System.Windows.Media.Imaging.BmpBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BmpBitmapDecoder

Public Sub New (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

Parameter

bitmapUri

Uri

Uri, der die zu decodierende Bitmap bezeichnet.

createOptions

BitmapCreateOptions

Initialisierungsoptionen für das Bitmap-Bild.

cacheOption

BitmapCacheOption

Die Zwischenspeicherungsmethode, die für das Bitmap-Bild verwendet werden soll.

Ausnahmen

ArgumentNullException

Der bitmapUri-Wert ist null.

FileFormatException

Das bitmapUri ist kein Bitmap-codiertes Bild (BMP).

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz von erstellt und aus BmpBitmapDecoder verwendet Uriwird. Das decodierte Bild wird als Quelle eines Steuerelements Image verwendet.

// Open a Uri and decode a BMP image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.bmp", UriKind::RelativeOrAbsolute);
BmpBitmapDecoder^ decoder2 = gcnew BmpBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource2 = decoder2->Frames[0];

// Draw the Image
Image^ myImage2 = gcnew Image();
myImage2->Source = bitmapSource2;
myImage2->Stretch = Stretch::None;
myImage2->Margin = System::Windows::Thickness(20);

// Open a Uri and decode a BMP image
Uri myUri = new Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute);
BmpBitmapDecoder decoder2 = new BmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];

// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

' Open a Uri and decode a BMP image
Dim myUri As New Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute)
Dim decoder2 As New BmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource2 As BitmapSource = decoder2.Frames(0)

' Draw the Image
Dim myImage2 As New Image()
myImage2.Source = bitmapSource2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)