This topic has not yet been rated - Rate this topic

BitmapEncoder.Save Method

Encodes a bitmap image to a specified Stream.

Namespace:  System.Windows.Media.Imaging
Assembly:  PresentationCore (in PresentationCore.dll)
[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public virtual void Save(
	Stream stream
)

Parameters

stream
Type: System.IO.Stream
Identifies the file stream that this bitmap is encoded to.
Exception Condition
InvalidOperationException

The bitmap has already been encoded.

NotSupportedException

The Frames value that is passed to the encoder is null.

NotSupportedException

The Frames count is less than or equal to zero.

In the context of this API, "save" and "encode" are synonymous.

The following example demonstrates how to save a bitmap image to a file stream by using the derived TiffBitmapEncoder class.


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);


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ