BitmapDecoder.Create 方法

定義

命名空間:

System.Windows.Media.Imaging

組件:

PresentationCore.dll

使用指定的 BitmapDecoder 和 BitmapCreateOptions 建立 BitmapCacheOption。

多載

Create(Stream, BitmapCreateOptions, BitmapCacheOption)	使用指定的 BitmapDecoder 和 Stream，從 BitmapCreateOptions 建立 BitmapCacheOption。
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	使用指定的 BitmapDecoder 和 Uri，從 BitmapCreateOptions 建立 BitmapCacheOption。
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	使用指定的 BitmapDecoder、Uri 和 BitmapCreateOptions，從 BitmapCacheOption 建立 RequestCachePolicy。

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

使用指定的 BitmapDecoder 和 Stream，從 BitmapCreateOptions 建立 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

參數

bitmapStream

Stream

用於識別要解碼之點陣圖的檔案資料流。

createOptions

BitmapCreateOptions

識別這個解碼器的 BitmapCreateOptions。

cacheOption

BitmapCacheOption

識別這個解碼器的 BitmapCacheOption。

傳回

BitmapDecoder

使用指定的 BitmapDecoder 和 Stream，從 BitmapCreateOptions 建立的 BitmapCacheOption。

範例

下列範例示範如何使用 Create 方法來建立指定影像的解碼器。 影像的第一個 BitmapFrame 是做為控制項的來源 Image 。

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)

備註

OnLoad如果您想要在建立解碼器之後關閉 ， bitmapStream 請使用快取選項。 預設 OnDemand 快取選項會保留資料流程的存取權，直到需要點陣圖，而且垃圾收集行程會處理清除。

另請參閱

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

使用指定的 BitmapDecoder 和 Uri，從 BitmapCreateOptions 建立 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

參數

bitmapUri

Uri

要解碼之點陣圖的 Uri。

createOptions

BitmapCreateOptions

識別這個解碼器的 BitmapCreateOptions。

cacheOption

BitmapCacheOption

識別這個解碼器的 BitmapCacheOption。

傳回

BitmapDecoder

使用指定的 BitmapDecoder 和 Uri，從 BitmapCreateOptions 建立的 BitmapCacheOption。

例外狀況

ArgumentNullException

bitmapUri 為 null。

FileFormatException

bitmapUri 指定不支援之格式類型的類別 ID。

範例

下列範例示範如何使用 Create(Uri, BitmapCreateOptions, BitmapCacheOption) 方法來建立指定影像的解碼器。 影像的第一個 BitmapFrame 是做為控制項的來源 Image 。

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)

另請參閱

• BitmapSource

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

使用指定的 BitmapDecoder、Uri 和 BitmapCreateOptions，從 BitmapCacheOption 建立 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

參數

bitmapUri

Uri

點陣圖的位置，其中會建立 BitmapDecoder。

createOptions

BitmapCreateOptions

用來建立這個 BitmapDecoder 的選項。

cacheOption

BitmapCacheOption

用來建立這個 BitmapDecoder 的快取選項。

uriCachePolicy

RequestCachePolicy

這個 BitmapDecoder 的快取需求。

傳回

BitmapDecoder

使用指定的 BitmapDecoder、Uri 和 BitmapCreateOptions，從 BitmapCacheOption 建立的 RequestCachePolicy。

備註

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy).NET Framework 3.5 版引進。