This documentation is archived and is not being maintained.

EncoderParameterValueType Enumeration

Used to specify the data type of the EncoderParameter used with the Save or SaveAdd method of an image.

Namespace:  System.Drawing.Imaging
Assembly:  System.Drawing (in System.Drawing.dll)

public enum EncoderParameterValueType

Member nameDescription
ValueTypeByteSpecifies that each value in the array is an 8-bit unsigned integer.
ValueTypeAsciiSpecifies that the array of values is a null-terminated ASCII character string. Note that the NumberOfValues data member of the EncoderParameter object indicates the length of the character string including the NULL terminator.
ValueTypeShortSpecifies that each value in the array is a 16-bit, unsigned integer.
ValueTypeLongSpecifies that each value in the array is a 32-bit unsigned integer.
ValueTypeRationalSpecifies that each value in the array is a pair of 32-bit unsigned integers. Each pair represents a fraction, the first integer being the numerator and the second integer being the denominator.
ValueTypeLongRangeSpecifies that each value in the array is a pair of 32-bit unsigned integers. Each pair represents a range of numbers.
ValueTypeUndefinedSpecifies that the array of values is an array of bytes that has no data type defined.
ValueTypeRationalRangeSpecifies that each value in the array is a set of four, 32-bit unsigned integers. The first two integers represent one fraction, and the second two integers represent a second fraction. The two fractions represent a range of rational numbers. The first fraction is the smallest rational number in the range, and the second fraction is the largest rational number in the range.

GDI+ uses image encoders to convert the images stored in Bitmap objects to various file formats. Image encoders are built into GDI+ for the BMP, JPEG, GIF, TIFF, and PNG formats. An encoder is invoked when you call the Save or SaveAdd method of a Bitmap object.

The NumberOfValues data member of the EncoderParameter object indicates the length of the character string including the null terminator.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.
Show: