JpegBitmapDecoder 建構函式

定義

命名空間:

System.Windows.Media.Imaging

組件:

PresentationCore.dll

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

多載

JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	使用指定的 createOptions 和 cacheOption，從指定的檔案資料流初始化 JpegBitmapDecoder 類別的新執行個體。
JpegBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	使用指定的 createOptions 和 cacheOption，從指定的 JpegBitmapDecoder 初始化 Uri 類別的新執行個體。

JpegBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

使用指定的 createOptions 和 cacheOption，從指定的檔案資料流初始化 JpegBitmapDecoder 類別的新執行個體。

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) 編碼影像。

範例

下列程式碼範例示範如何建立 的實例，以及從檔案資料流程使用 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)

使用指定的 createOptions 和 cacheOption，從指定的 JpegBitmapDecoder 初始化 Uri 類別的新執行個體。

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) 編碼影像。

範例

下列程式碼範例示範如何建立 的實例，以及從 Uri 使用 JpegBitmapDecoder 。 解碼的影像會當做控制項的來源 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 ，就會發生例外狀況。