WmpBitmapDecoder 构造函数

定义

命名空间:

System.Windows.Media.Imaging

程序集:

PresentationCore.dll

初始化 WmpBitmapDecoder 的新实例。

重载

WmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)	从指定的文件流，用指定的 createOptions 和 cacheOption 初始化 WmpBitmapDecoder 类的一个新实例。
WmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)	从指定的 WmpBitmapDecoder，用指定的 createOptions 和 cacheOption 初始化 Uri 的一个新实例。

WmpBitmapDecoder(Stream, BitmapCreateOptions, BitmapCacheOption)

从指定的文件流，用指定的 createOptions 和 cacheOption 初始化 WmpBitmapDecoder 类的一个新实例。

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

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

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

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

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

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

参数

bitmapStream

Stream

要解码的位图流。

createOptions

BitmapCreateOptions

位图图像的初始化选项。

cacheOption

BitmapCacheOption

位图图像的缓存方法。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

bitmapStream 值为 null。

FileFormatException

bitmapStream这不是Windows媒体照片编码的图像。

示例

下面的代码示例演示如何从文件流创建和使用 WmpBitmapDecoder 实例。 解码的图像用作控件的 Image 源。

// Open a Stream and decode a WDP image
Stream^ imageStreamSource = gcnew FileStream("tulipfarm.wdp", FileMode::Open, FileAccess::Read, FileShare::Read);
WmpBitmapDecoder^ decoder = gcnew WmpBitmapDecoder(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 WDP image
Stream imageStreamSource = new FileStream("tulipfarm.wdp", FileMode.Open, FileAccess.Read, FileShare.Read);
WmpBitmapDecoder decoder = new WmpBitmapDecoder(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 WDP image
Dim imageStreamSource As New FileStream("tulipfarm.wdp", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New WmpBitmapDecoder(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 缓存选项将保留对流的访问，直到需要位图，并由垃圾回收器处理清理。

WmpBitmapDecoder(Uri, BitmapCreateOptions, BitmapCacheOption)

从指定的 WmpBitmapDecoder，用指定的 createOptions 和 cacheOption 初始化 Uri 的一个新实例。

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

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

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

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

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

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这不是Windows媒体照片编码的图像。

示例

下面的代码示例演示如何创建实例并使用 WmpBitmapDecoder a Uri. 解码的图像用作控件的 Image 源。

// Open a Uri and decode a WDP image
System::Uri^ myUri = gcnew System::Uri("tulipfarm.wdp", UriKind::RelativeOrAbsolute);
WmpBitmapDecoder^ decoder3 = gcnew WmpBitmapDecoder(myUri, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapSource^ bitmapSource3 = decoder3->Frames[0];

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

// Open a Uri and decode a WDP image
Uri myUri = new Uri("tulipfarm.wdp", UriKind.RelativeOrAbsolute);
WmpBitmapDecoder decoder3 = new WmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource3 = decoder3.Frames[0];

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

' Open a Uri and decode a WDP image
Dim myUri As New Uri("tulipfarm.wdp", UriKind.RelativeOrAbsolute)
Dim decoder3 As New WmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource3 As BitmapSource = decoder3.Frames(0)

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