TiffBitmapDecoder 建構函式

定義

命名空間:: System.Windows.Media.Imaging

組件:: PresentationCore.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
TiffBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	從指定的檔案串流初始化該類別的新實例TiffBitmapDecoder，並指定`createOptionscacheOption`為。
TiffBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	初始化該類別的新實例TiffBitmapDecoder，來自指定的 Uri，並指定`createOptionscacheOption`為。

TiffBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

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

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

[System.Security.SecurityCritical]
public TiffBitmapDecoder(System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

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

[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.TiffBitmapDecoder : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.TiffBitmapDecoder

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

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

參數

bitmapStream: Stream

要解碼的點陣圖串流。

createOptions: BitmapCreateOptions

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

cacheOption: BitmapCacheOption

點陣圖影像的快取方法。

屬性: SecurityCriticalAttribute

例外狀況

ArgumentNullException

bitmapStream 值是 null。

FileFormatException

這 bitmapStream 不是標籤影像檔案格式（TIFF）編碼的影像。

範例

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

// Open a Stream and decode a TIFF image.
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.tif", FileMode::Open, FileAccess::Read, FileShare::Read);
TiffBitmapDecoder^ decoder = gcnew TiffBitmapDecoder(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 TIFF image.
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
var decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

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

' Open a Stream and decode a TIFF image.
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(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 快取選項保留對串流的存取權，直到需要位圖，且垃圾回收器負責清理。

適用於

TiffBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

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

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

[System.Security.SecurityCritical]
public TiffBitmapDecoder(Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

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

[<System.Security.SecurityCritical>]
new System.Windows.Media.Imaging.TiffBitmapDecoder : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.TiffBitmapDecoder

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

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 不是標籤影像檔案格式（TIFF）編碼的影像。

範例

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


// Open a Uri and decode a TIFF image.
System::Uri^ myUri = gcnew System::Uri("tulipfarm.tif", UriKind::RelativeOrAbsolute);
TiffBitmapDecoder^ decoder2 = gcnew TiffBitmapDecoder(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 TIFF image.
var myUri = new Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute);
var decoder2 = new TiffBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];

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

' Open a Uri and decode a TIFF image.
Dim myUri As New Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute)
Dim decoder2 As New TiffBitmapDecoder(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)

適用於

意見反應

此頁面對您有幫助嗎？