語言

JpegBitmapDecoder 建構函式

定義

命名空間:
System.Windows.Media.Imaging
組件:
PresentationCore.dll

初始化 JpegBitmapDecoder 類別的新執行個體。

多載

名稱 Description
JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

從指定的檔案串流初始化該類別的新實例JpegBitmapDecoder，並指定createOptionscacheOption為 。
JpegBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

初始化該類別的新實例JpegBitmapDecoder，來自指定的 Uri，並指定createOptionscacheOption為 。

JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

從指定的檔案串流初始化該類別的新實例JpegBitmapDecoder，並指定createOptionscacheOption為 。

public:
 JpegBitmapDecoder(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
[System.Security.SecurityCritical]
public JpegBitmapDecoder(System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
public JpegBitmapDecoder(System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.JpegBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder
new System.Windows.Media.Imaging.JpegBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder
Public Sub New (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

參數

bitmapStream
Stream

要解碼的點陣圖串流。

createOptions
BitmapCreateOptions

點陣圖影像的初始化選項。

cacheOption
BitmapCacheOption

用於點陣圖影像的快取方法。

屬性
SecurityCriticalAttribute

例外狀況

ArgumentNullException

bitmapStream 值是 null。

FileFormatException

這 bitmapStream 張圖片並非由聯合攝影專家組（JPEG）編碼。

範例

以下程式碼範例示範如何從檔案串流建立並使用 a JpegBitmapDecoder 實例。 解碼後的影像作為控制的來源 Image 。

// Open a Stream and decode a JPEG image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.jpg", FileMode::Open, FileAccess::Read, FileShare::Read);
JpegBitmapDecoder^ decoder = gcnew JpegBitmapDecoder(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 JPEG image
Stream imageStreamSource = new FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read);
JpegBitmapDecoder decoder = new JpegBitmapDecoder(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 JPEG image
Dim imageStreamSource As New FileStream("tulipfarm.jpg", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New JpegBitmapDecoder(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)

備註

如果你想在解碼器建立後關閉快OnLoad取，可以使用bitmapStream快取選項。 預設 OnDemand 快取選項保留對串流的存取權，直到需要位圖，且垃圾回收器負責清理。

適用於

JpegBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

初始化該類別的新實例JpegBitmapDecoder，來自指定的 Uri，並指定createOptionscacheOption為 。

public:
 JpegBitmapDecoder(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);
[System.Security.SecurityCritical]
public JpegBitmapDecoder(Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
public JpegBitmapDecoder(Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);
[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.JpegBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder
new System.Windows.Media.Imaging.JpegBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.JpegBitmapDecoder
Public Sub New (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption)

參數

bitmapUri
Uri

那 Uri 個用來識別要解碼的位圖。

createOptions
BitmapCreateOptions

點陣圖影像的初始化選項。

cacheOption
BitmapCacheOption

用於點陣圖影像的快取方法。

屬性
SecurityCriticalAttribute

例外狀況

ArgumentNullException

bitmapUri 值是 null。

FileFormatException

這 bitmapUri 張圖片並非由聯合攝影專家組（JPEG）編碼。

範例

以下程式碼範例示範如何從 中建立 的實例並使用 a JpegBitmapDecoderUri。 解碼後的影像作為控制的來源 Image 。

// Open a Uri and decode a JPEG image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.jpg", UriKind::RelativeOrAbsolute);
JpegBitmapDecoder^ decoder2 = gcnew JpegBitmapDecoder(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 JPEG image
Uri myUri = new Uri("tulipfarm.jpg", UriKind.RelativeOrAbsolute);
JpegBitmapDecoder decoder2 = new JpegBitmapDecoder(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 JPEG image
Dim myUri As New Uri("tulipfarm.jpg", UriKind.RelativeOrAbsolute)
Dim decoder2 As New JpegBitmapDecoder(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)

備註

若解碼器無法載入指定的 bitmapUri。

適用於