EncoderParameter 构造函数

定义

使用指定的 EncoderParameter 对象和值初始化 Encoder 类的一个新实例。

重载

EncoderParameter(Encoder, Byte)

用指定的 EncoderParameter 对象和一个无符号 8 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeByte,并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])

用指定的 EncoderParameter 对象和四个 32 位整数数组初始化 Encoder 类的新实例。 这四个数组表示一个数组有理范围。 有理范围是指从最小分数值到最大分数值的所有分数的集。 将 ValueType 属性设置为 ValueTypeRationalRange,将 NumberOfValues 属性设置为 numerator1 数组中的元素数,该元素数必须与其他三个数组中的元素数相同。

EncoderParameter(Encoder, Int32, Int32, Int32, Int32)

用指定的 EncoderParameter 对象和四个 32 位整数初始化 Encoder 类的新实例。 这四个整数表示一个分数范围。 前两个整数表示该范围中最小的分数,而后两个整数表示该范围中最大的分数。 将 ValueType 属性设置为 ValueTypeRationalRange,并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Int32, Int32)

使用指定的 Encoder 对象和 32 位整数对初始化 EncoderParameter 类的新实例。 整数对表示一个分数,第一个整数为分子,第二个整数为分母。 将 ValueType 属性设置为 ValueTypeRational,并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Int32, Int32, Int32)
已过时.
已过时.
已过时.

用指定的 EncoderParameter 对象和三个整数初始化 Encoder 类的新实例,这三个整数分别指定值的数目、值的数据类型和指向存储在 EncoderParameter 对象中的值的指针。

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

用指定的 EncoderParameter 对象和三个整数初始化 Encoder 类的新实例,这三个整数分别指定值的数目、值的数据类型和指向存储在 EncoderParameter 对象中的值的指针。

EncoderParameter(Encoder, Int64, Int64)

使用指定的 Encoder 对象和 64 位整数对初始化 EncoderParameter 类的新实例。 这对整数代表一个整数范围,第一个整数是该范围中最小的数,第二个整数是该范围中最大的数。 将 ValueType 属性设置为 ValueTypeLongRange,并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Int32[], Int32[])

用指定的 EncoderParameter 对象和两个 32 位整数数组初始化 Encoder 类的新实例。 这两个数组表示一个分数数组。 将 ValueType 属性设置为 ValueTypeRational,并将 NumberOfValues 属性设置为 numerator 数组中的元素数,它必须与 denominator 数组中的元素数相同。

EncoderParameter(Encoder, Int64[], Int64[])

用指定的 EncoderParameter 对象和两个 64 位整数数组初始化 Encoder 类的新实例。 这两个数组表示一组整数范围。 将 ValueType 属性设置为 ValueTypeLongRange,并将 NumberOfValues 属性设置为 rangebegin 数组中的元素数,它必须与 rangeend 数组中的元素数相同。

EncoderParameter(Encoder, Byte, Boolean)

用指定的 EncoderParameter 对象和一个 8 位值初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeUndefinedValueTypeByte,将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, String)

用指定的 EncoderParameter 对象和字符串初始化 Encoder 类的新实例。 该字符串在存储到 EncoderParameter 对象中之前,被转换成一个用 NULL 结束符终止的 ASCII 字符串。 将 ValueType 属性设置为 ValueTypeAscii,并将 NumberOfValues 属性设置为此 ASCII 字符串的长度,该长度包括 NULL 结束符。

EncoderParameter(Encoder, Int64[])

用指定的 EncoderParameter 对象和一个 64 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeLong(32 位),将 NumberOfValues 属性设置为数组中的元素数。

EncoderParameter(Encoder, Int64)

用指定的 EncoderParameter 对象和一个 64 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeLong(32 位),并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Int16[])

用指定的 EncoderParameter 对象和一个 16 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeShort,将 NumberOfValues 属性设置为数组中的元素数。

EncoderParameter(Encoder, Int16)

用指定的 EncoderParameter 对象和一个 16 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeShort,并将 NumberOfValues 属性设置为 1。

EncoderParameter(Encoder, Byte[])

用指定的 EncoderParameter 对象和一个无符号的 8 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeByte,将 NumberOfValues 属性设置为数组中的元素数。

EncoderParameter(Encoder, Byte[], Boolean)

用指定的 EncoderParameter 对象和一个字节数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeUndefinedValueTypeByte,将 NumberOfValues 属性设置为数组中的元素数。

EncoderParameter(Encoder, Byte)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个无符号 8 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeByte,并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::Byte value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Byte)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Byte

8 位无符号整数,指定存储在 EncoderParameter 对象中的值。

适用于

EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和四个 32 位整数数组初始化 Encoder 类的新实例。 这四个数组表示一个数组有理范围。 有理范围是指从最小分数值到最大分数值的所有分数的集。 将 ValueType 属性设置为 ValueTypeRationalRange,将 NumberOfValues 属性设置为 numerator1 数组中的元素数,该元素数必须与其他三个数组中的元素数相同。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <int> ^ numerator1, cli::array <int> ^ denominator1, cli::array <int> ^ numerator2, cli::array <int> ^ denominator2);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int[] numerator1, int[] denominator1, int[] numerator2, int[] denominator2);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int[] * int[] * int[] * int[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, numerator1 As Integer(), denominator1 As Integer(), numerator2 As Integer(), denominator2 As Integer())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

numerator1
Int32[]

32 位整数数组,它指定该范围中最小值的分子。 数组中的整数必须是非负的。

denominator1
Int32[]

32 位整数数组,它指定该范围中最小值的分母。 数组中的整数必须是非负的。

numerator2
Int32[]

32 位整数数组,它指定该范围中最大值的分子。 数组中的整数必须是非负的。

denominator2
Int32[]

32 位整数数组,它指定该范围中最大值的分母。 数组中的整数必须是非负的。

注解

ith 范围由从分子 1[i]/分母 1[i] 到 numerator2[i]/分母 2[i] 的所有小数组成。

适用于

EncoderParameter(Encoder, Int32, Int32, Int32, Int32)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和四个 32 位整数初始化 Encoder 类的新实例。 这四个整数表示一个分数范围。 前两个整数表示该范围中最小的分数,而后两个整数表示该范围中最大的分数。 将 ValueType 属性设置为 ValueTypeRationalRange,并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numerator1, int demoninator1, int numerator2, int demoninator2);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numerator1, int demoninator1, int numerator2, int demoninator2);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int * int -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, numerator1 As Integer, demoninator1 As Integer, numerator2 As Integer, demoninator2 As Integer)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

numerator1
Int32

一个 32 整数,它表示该范围中最小分数的分子。 必须为非负数。

demoninator1
Int32

一个 32 整数,它表示该范围中最小分数的分母。 必须为非负数。

numerator2
Int32

一个 32 整数,它表示该范围中最小分数的分母。 必须为非负数。

demoninator2
Int32

一个 32 位整数,它表示该范围中最大分数的分子。 必须为非负数。

适用于

EncoderParameter(Encoder, Int32, Int32)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

使用指定的 Encoder 对象和 32 位整数对初始化 EncoderParameter 类的新实例。 整数对表示一个分数,第一个整数为分子,第二个整数为分母。 将 ValueType 属性设置为 ValueTypeRational,并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numerator, int denominator);
public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numerator, int demoninator);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numerator, int denominator);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numerator, int demoninator);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int -> System.Drawing.Imaging.EncoderParameter
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, numerator As Integer, denominator As Integer)
Public Sub New (encoder As Encoder, numerator As Integer, demoninator As Integer)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

numerator
Int32

一个表示分数分子的 32 位整数。 必须为非负数。

denominatordemoninator
Int32

一个表示分数分母的 32 位整数。 必须为非负数。

适用于

EncoderParameter(Encoder, Int32, Int32, Int32)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

注意

This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead. http://go.microsoft.com/fwlink/?linkid=14202

注意

This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead. https://go.microsoft.com/fwlink/?linkid=14202

注意

This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.

用指定的 EncoderParameter 对象和三个整数初始化 Encoder 类的新实例,这三个整数分别指定值的数目、值的数据类型和指向存储在 EncoderParameter 对象中的值的指针。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int NumberOfValues, int Type, int Value);
[System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int NumberOfValues, int Type, int Value);
[System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int NumberOfValues, int Type, int Value);
[System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.")]
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int NumberOfValues, int Type, int Value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int NumberOfValues, int Type, int Value);
[<System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int -> System.Drawing.Imaging.EncoderParameter
[<System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int -> System.Drawing.Imaging.EncoderParameter
[<System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.")>]
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int -> System.Drawing.Imaging.EncoderParameter
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, NumberOfValues As Integer, Type As Integer, Value As Integer)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

NumberOfValues
Int32

一个整数,它指定 EncoderParameter 对象中存储的值的数目。 NumberOfValues 属性被设置为该值。

Type
Int32

EncoderParameterValueType 枚举的成员,它指定存储在此 EncoderParameter 对象中的值的数据类型。 TypeValueType 属性设置为该值。

Value
Int32

指向由 Type 参数指定的类型的值数组的指针。

属性

例外

适用于

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和三个整数初始化 Encoder 类的新实例,这三个整数分别指定值的数目、值的数据类型和指向存储在 EncoderParameter 对象中的值的指针。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numberValues, System::Drawing::Imaging::EncoderParameterValueType type, IntPtr value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numberValues, System.Drawing.Imaging.EncoderParameterValueType type, IntPtr value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * System.Drawing.Imaging.EncoderParameterValueType * nativeint -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, numberValues As Integer, type As EncoderParameterValueType, value As IntPtr)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

numberValues
Int32

一个整数,它指定 EncoderParameter 对象中存储的值的数目。 NumberOfValues 属性被设置为该值。

type
EncoderParameterValueType

EncoderParameterValueType 枚举的成员,它指定存储在此 EncoderParameter 对象中的值的数据类型。 TypeValueType 属性设置为该值。

value
IntPtr

nativeint

指向由 Type 参数指定的类型的值数组的指针。

适用于

EncoderParameter(Encoder, Int64, Int64)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

使用指定的 Encoder 对象和 64 位整数对初始化 EncoderParameter 类的新实例。 这对整数代表一个整数范围,第一个整数是该范围中最小的数,第二个整数是该范围中最大的数。 将 ValueType 属性设置为 ValueTypeLongRange,并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, long rangebegin, long rangeend);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long rangebegin, long rangeend);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64 * int64 -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, rangebegin As Long, rangeend As Long)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

rangebegin
Int64

一个 64 位整数,它表示一个整数范围中最小的数。 必须为非负数。 该参数在存储到 EncoderParameter 对象中之前被转换为 32 位整数。

rangeend
Int64

一个 64 位整数,它表示一个整数范围中最大的数。 必须为非负数。 该参数在存储到 EncoderParameter 对象中之前被转换为 32 位整数。

适用于

EncoderParameter(Encoder, Int32[], Int32[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和两个 32 位整数数组初始化 Encoder 类的新实例。 这两个数组表示一个分数数组。 将 ValueType 属性设置为 ValueTypeRational,并将 NumberOfValues 属性设置为 numerator 数组中的元素数,它必须与 denominator 数组中的元素数相同。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <int> ^ numerator, cli::array <int> ^ denominator);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int[] numerator, int[] denominator);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int[] * int[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, numerator As Integer(), denominator As Integer())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

numerator
Int32[]

一个 32 位整数数组,它指定分数的分子。 数组中的整数必须是非负的。

denominator
Int32[]

一个 32 位整数数组,它指定分数的分母。 数组中的整数必须是非负的。 给定索引的分母与同一索引的分子成对出现。

适用于

EncoderParameter(Encoder, Int64[], Int64[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和两个 64 位整数数组初始化 Encoder 类的新实例。 这两个数组表示一组整数范围。 将 ValueType 属性设置为 ValueTypeLongRange,并将 NumberOfValues 属性设置为 rangebegin 数组中的元素数,它必须与 rangeend 数组中的元素数相同。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <long> ^ rangebegin, cli::array <long> ^ rangeend);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long[] rangebegin, long[] rangeend);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64[] * int64[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, rangebegin As Long(), rangeend As Long())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

rangebegin
Int64[]

一个 64 位整数数组,它指定该整数范围中的最小值。 数组中的整数必须是非负的。 64 位整数在存储到 EncoderParameter 对象中之前被转换为 32 位整数。

rangeend
Int64[]

一个 64 位整数数组,它指定该整数范围中的最大值。 数组中的整数必须是非负的。 64 位整数在存储到 EncoderParameters 对象中之前被转换为 32 位整数。 给定索引的最大值与同一索引的最小值成对出现。

适用于

EncoderParameter(Encoder, Byte, Boolean)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个 8 位值初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeUndefinedValueTypeByte,将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::Byte value, bool undefined);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte value, bool undefined);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte * bool -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Byte, undefined As Boolean)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Byte

一个字节,用于指定 EncoderParameter 对象中存储的值。

undefined
Boolean

如果为 trueValueType 属性将设置为 ValueTypeUndefined;否则,ValueType 属性设置为 ValueTypeByte

适用于

EncoderParameter(Encoder, String)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和字符串初始化 Encoder 类的新实例。 该字符串在存储到 EncoderParameter 对象中之前,被转换成一个用 NULL 结束符终止的 ASCII 字符串。 将 ValueType 属性设置为 ValueTypeAscii,并将 NumberOfValues 属性设置为此 ASCII 字符串的长度,该长度包括 NULL 结束符。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::String ^ value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, string value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * string -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As String)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
String

一个 String,它指定 EncoderParameter 对象中存储的值。

适用于

EncoderParameter(Encoder, Int64[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个 64 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeLong(32 位),将 NumberOfValues 属性设置为数组中的元素数。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <long> ^ value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long[] value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Long())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Int64[]

一个 64 位整数数组,用于指定存储在 EncoderParameter 对象中的值。 数组中的整数必须是非负的。 64 位整数在存储到 EncoderParameter 对象中之前被转换为 32 位整数。

适用于

EncoderParameter(Encoder, Int64)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个 64 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeLong(32 位),并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, long value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64 -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Long)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Int64

64 位整数,指定存储在 EncoderParameter 对象中的值。 必须为非负数。 该参数在存储到 EncoderParameter 对象中之前被转换为 32 位整数。

示例

下面的代码示例演示如何使用 EncoderParameter 构造函数创建 EncoderParameter 。 若要运行此示例,请将代码粘贴到 Windows 窗体中,并从窗体的构造函数调用 VaryQualityLevel 方法。 此示例需要一个名为 TestPhoto.jpg 的图像文件,该文件位于 c:\

private void VaryQualityLevel()
{
    // Get a bitmap.
    Bitmap bmp1 = new Bitmap(@"c:\TestPhoto.jpg");
    ImageCodecInfo jpgEncoder = GetEncoder(ImageFormat.Jpeg);

    // Create an Encoder object based on the GUID
    // for the Quality parameter category.
    System.Drawing.Imaging.Encoder myEncoder =
        System.Drawing.Imaging.Encoder.Quality;

    // Create an EncoderParameters object.
    // An EncoderParameters object has an array of EncoderParameter
    // objects. In this case, there is only one
    // EncoderParameter object in the array.
    EncoderParameters myEncoderParameters = new EncoderParameters(1);

    EncoderParameter myEncoderParameter = new EncoderParameter(myEncoder, 50L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityFifty.jpg", jpgEncoder, myEncoderParameters);

    myEncoderParameter = new EncoderParameter(myEncoder, 100L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityHundred.jpg", jpgEncoder, myEncoderParameters);

    // Save the bitmap as a JPG file with zero quality level compression.
    myEncoderParameter = new EncoderParameter(myEncoder, 0L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityZero.jpg", jpgEncoder, myEncoderParameters);
}
Private Sub VaryQualityLevel()
    ' Get a bitmap.
    Dim bmp1 As New Bitmap("c:\TestPhoto.jpg")
    Dim jpgEncoder As ImageCodecInfo = GetEncoder(ImageFormat.Jpeg)

    ' Create an Encoder object based on the GUID
    ' for the Quality parameter category.
    Dim myEncoder As System.Drawing.Imaging.Encoder = System.Drawing.Imaging.Encoder.Quality

    ' Create an EncoderParameters object.
    ' An EncoderParameters object has an array of EncoderParameter
    ' objects. In this case, there is only one
    ' EncoderParameter object in the array.
    Dim myEncoderParameters As New EncoderParameters(1)

    Dim myEncoderParameter As New EncoderParameter(myEncoder, 50&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityFifty.jpg", jpgEncoder, myEncoderParameters)

    myEncoderParameter = New EncoderParameter(myEncoder, 100&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityHundred.jpg", jpgEncoder, myEncoderParameters)

    ' Save the bitmap as a JPG file with zero quality level compression.
    myEncoderParameter = New EncoderParameter(myEncoder, 0&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityZero.jpg", jpgEncoder, myEncoderParameters)

End Sub
private ImageCodecInfo GetEncoder(ImageFormat format)
{
    ImageCodecInfo[] codecs = ImageCodecInfo.GetImageEncoders();

    foreach (ImageCodecInfo codec in codecs)
    {
        if (codec.FormatID == format.Guid)
        {
            return codec;
        }
    }
    
    return null;
}
Private Function GetEncoder(ByVal format As ImageFormat) As ImageCodecInfo

    Dim codecs As ImageCodecInfo() = ImageCodecInfo.GetImageEncoders()

    Dim codec As ImageCodecInfo
    For Each codec In codecs
        If codec.FormatID = format.Guid Then
            Return codec
        End If
    Next codec
    Return Nothing

End Function

适用于

EncoderParameter(Encoder, Int16[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个 16 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeShort,将 NumberOfValues 属性设置为数组中的元素数。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <short> ^ value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, short[] value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int16[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Short())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Int16[]

一个 16 位整数数组,用于指定存储在 EncoderParameter 对象中的值。 数组中的整数必须是非负的。

适用于

EncoderParameter(Encoder, Int16)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个 16 位整数初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeShort,并将 NumberOfValues 属性设置为 1。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, short value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, short value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int16 -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Short)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Int16

16 位整数,指定存储在 EncoderParameter 对象中的值。 必须为非负数。

适用于

EncoderParameter(Encoder, Byte[])

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个无符号的 8 位整数数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeByte,将 NumberOfValues 属性设置为数组中的元素数。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <System::Byte> ^ value);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte[] value);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte[] -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Byte())

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Byte[]

一个无符号的 8 位整数数组,用于指定存储在 EncoderParameter 对象中的值。

适用于

EncoderParameter(Encoder, Byte[], Boolean)

Source:
EncoderParameter.cs
Source:
EncoderParameter.cs
Source:
EncoderParameter.cs

用指定的 EncoderParameter 对象和一个字节数组初始化 Encoder 类的新实例。 将 ValueType 属性设置为 ValueTypeUndefinedValueTypeByte,将 NumberOfValues 属性设置为数组中的元素数。

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <System::Byte> ^ value, bool undefined);
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte[] value, bool undefined);
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte[] * bool -> System.Drawing.Imaging.EncoderParameter
Public Sub New (encoder As Encoder, value As Byte(), undefined As Boolean)

参数

encoder
Encoder

一个 Encoder 对象,用于封装参数类别的全局唯一标识符。

value
Byte[]

一个字节数组,用于指定 EncoderParameter 对象中存储的值。

undefined
Boolean

如果为 trueValueType 属性将设置为 ValueTypeUndefined;否则,ValueType 属性设置为 ValueTypeByte

适用于