BitmapFrame.Create 方法

参考

定义

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

程序集:: PresentationCore.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

根据提供的参数，创建新的 BitmapFrame。

重载

Create(Stream)	使用指定的缩略图、 BitmapFrame 和 Stream。
Create(Uri)	使用指定的缩略图、 BitmapFrame 和 Uri。
Create(BitmapSource)	使用指定的缩略图、 BitmapFrame 和 BitmapSource。
Create(Uri, RequestCachePolicy)	用指定的 BitmapFrame 从给定的 Uri 创建 RequestCachePolicy。
Create(BitmapSource, BitmapSource)	用指定的缩略图从给定的 BitmapFrame 创建新的 BitmapSource。
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	用指定的 BitmapFrame 和 Stream 从给定的 BitmapCreateOptions 创建新的 BitmapCacheOption。
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	用指定的 BitmapFrame 和 Uri 从给定的 BitmapCreateOptions 创建 BitmapCacheOption。
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	用指定的 BitmapFrame、Uri 和 BitmapCreateOptions 从给定的 BitmapCacheOption 创建 RequestCachePolicy。
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	使用指定的缩略图、BitmapMetadata 和 ColorContext 从给定的 BitmapSource 创建新的 BitmapFrame。

Create(Stream)

使用指定的缩略图、 BitmapFrame 和 Stream。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::IO::Stream ^ bitmapStream);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.IO.Stream bitmapStream);

static member Create : System.IO.Stream -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream) As BitmapFrame

参数

bitmapStream: Stream

用于构造 Stream 的 BitmapFrame。

BitmapFrame

使用指定的缩略图、 BitmapFrame 和 Stream。

注解

bitmapStream仅当使用缓存选项时，才能在创建帧后OnLoad关闭该帧。默认 OnDemand 缓存选项将保留流，直到需要帧。使用该方法 Create(Stream, BitmapCreateOptions, BitmapCacheOption) 指定创建和缓存选项。

适用于

Create(Uri)

使用指定的缩略图、 BitmapFrame 和 Uri。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri);

static member Create : Uri -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri) As BitmapFrame

参数

bitmapUri: Uri

标识 Uri 的源的 BitmapFrame。

BitmapFrame

使用指定的缩略图、 BitmapFrame 和 Uri。

示例

下面的代码示例演示如何从给定Uri的构造BitmapFrame值。

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

适用于

Create(BitmapSource)

使用指定的缩略图、 BitmapFrame 和 BitmapSource。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source);

static member Create : System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource) As BitmapFrame

参数

source: BitmapSource

用于构造此 BitmapFrame 的 BitmapSource。

BitmapFrame

使用指定的缩略图、 BitmapFrame 和 BitmapSource。

适用于

Create(Uri, RequestCachePolicy)

用指定的 BitmapFrame 从给定的 Uri 创建 RequestCachePolicy。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, uriCachePolicy As RequestCachePolicy) As BitmapFrame

参数

bitmapUri: Uri

位图的位置，从该位置创建 BitmapFrame。

uriCachePolicy: RequestCachePolicy

此 BitmapFrame 的缓存要求。

BitmapFrame

一个 BitmapFrame，根据给定的 Uri，使用指定的 RequestCachePolicy。

注解

Create(Uri, RequestCachePolicy)在 .NET Framework 版本 3.5 中引入。有关详细信息，请参见版本和依赖关系。

适用于

Create(BitmapSource, BitmapSource)

用指定的缩略图从给定的 BitmapFrame 创建新的 BitmapSource。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource) As BitmapFrame

参数

source: BitmapSource

从中构造 BitmapFrame 的源。

thumbnail: BitmapSource

生成的 BitmapFrame 的缩略图。

BitmapFrame

一个 BitmapFrame，根据给定的 BitmapSource，使用指定的缩略图。

适用于

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

用指定的 BitmapFrame 和 Stream 从给定的 BitmapCreateOptions 创建新的 BitmapCacheOption。

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

public static System.Windows.Media.Imaging.BitmapFrame 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.BitmapFrame

Public Shared Function Create (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

参数

bitmapStream: Stream

从中构造此 BitmapFrame 的流。

createOptions: BitmapCreateOptions

用于创建此 BitmapFrame 的选项。

cacheOption: BitmapCacheOption

用于创建此 BitmapFrame 的缓存选项。

BitmapFrame

一个 BitmapFrame，根据给定的 Stream，使用指定的 BitmapCreateOptions 和 BitmapCacheOption。

注解

OnLoad如果要关闭bitmapStream创建位图后，请使用缓存选项。默认 OnDemand 缓存选项将保留对流的访问，直到需要位图并由垃圾回收器处理清理。

适用于

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

用指定的 BitmapFrame 和 Uri 从给定的 BitmapCreateOptions 创建 BitmapCacheOption。

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

public static System.Windows.Media.Imaging.BitmapFrame 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.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

参数

bitmapUri: Uri

位图的位置，从该位置创建 BitmapFrame。

createOptions: BitmapCreateOptions

用于创建此 BitmapFrame 的选项。

cacheOption: BitmapCacheOption

用于创建此 BitmapFrame 的缓存选项。

BitmapFrame

一个 BitmapFrame，根据给定的 Uri，使用指定的 BitmapCreateOptions 和 BitmapCacheOption。

适用于

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

用指定的 BitmapFrame、Uri 和 BitmapCreateOptions 从给定的 BitmapCacheOption 创建 RequestCachePolicy。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ 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.BitmapFrame 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.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption, uriCachePolicy As RequestCachePolicy) As BitmapFrame

参数

bitmapUri: Uri

位图的位置，从该位置创建 BitmapFrame。

createOptions: BitmapCreateOptions

用于创建此 BitmapFrame 的选项。

cacheOption: BitmapCacheOption

用于创建此 BitmapFrame 的缓存选项。

uriCachePolicy: RequestCachePolicy

此 BitmapFrame 的缓存要求。

BitmapFrame

一个 BitmapFrame，根据给定的 Uri，使用指定的 BitmapCreateOptions、BitmapCacheOption 和 RequestCachePolicy。

注解

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)在 .NET Framework 版本 3.5 中引入。有关详细信息，请参见版本和依赖关系。

适用于

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

使用指定的缩略图、BitmapMetadata 和 ColorContext 从给定的 BitmapSource 创建新的 BitmapFrame。

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail, System::Windows::Media::Imaging::BitmapMetadata ^ metadata, System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::ColorContext ^> ^ colorContexts);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail, System.Windows.Media.Imaging.BitmapMetadata metadata, System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> colorContexts);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapMetadata * System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource, metadata As BitmapMetadata, colorContexts As ReadOnlyCollection(Of ColorContext)) As BitmapFrame

参数

source: BitmapSource

用于构造此 BitmapFrame 的 BitmapSource。

thumbnail: BitmapSource

生成的 BitmapFrame 的缩略图。

metadata: BitmapMetadata

要与此 BitmapFrame 关联的元数据。

colorContexts: ReadOnlyCollection<ColorContext>

与此 BitmapFrame 关联的 ColorContext 对象。

BitmapFrame

使用指定的缩略图、BitmapMetadata 和 ColorContext 从给定的 BitmapSource 创建的 BitmapFrame。

适用于

BitmapFrame.Create 方法

定义

重载

Create(Stream)

参数

返回

注解

适用于

Create(Uri)

参数

返回

示例

适用于

Create(BitmapSource)

参数

返回

适用于

Create(Uri, RequestCachePolicy)

参数

返回

注解

适用于

Create(BitmapSource, BitmapSource)

参数

返回

适用于

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

参数

返回

注解

适用于

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

参数

返回

适用于

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

参数

返回

注解

适用于

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

参数

返回

适用于

其他资源