EncoderParameter 构造函数

定义

命名空间:: System.Drawing.Imaging

程序集:: System.Drawing.Common.dll

程序集:: System.Drawing.dll

包:: System.Drawing.Common v11.0.0-preview.4.26230.115

重要

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

使用指定的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)	使用指定的EncoderParameter对象和一对 32 位整数初始化类的新实例Encoder。整数对表示一个分数，第一个整数是分子，第二个整数是分母。将 ValueType 属性设置为 ValueTypeRational，并将 NumberOfValues 属性设置为 1。
EncoderParameter(Encoder, Int32, Int32, Int32)	已过时. 已过时. 已过时. 使用指定的EncoderParameter对象和三个整数初始化类的新实例Encoder，该实例指定值的数量、值的数据类型以及指向对象中存储的值的EncoderParameter指针。
EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)	使用指定的EncoderParameter对象、值数、值的数据类型以及指向对象中Encoder存储的值的指针初始化类的新实例EncoderParameter。
EncoderParameter(Encoder, Int64, Int64)	使用指定的EncoderParameter对象和一对 64 位整数初始化类的新实例Encoder。整数对表示整数范围，第一个整数是区域中的最小数字，第二个整数是范围中的最大数字。将 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属性设置为或ValueTypeUndefined将属性设置为 ValueTypeByte NumberOfValues 1。
EncoderParameter(Encoder, String)	使用指定的EncoderParameter对象和字符串初始化类的新实例Encoder。在对象中存储字符串之前，该字符串将转换为以 null 结尾的 EncoderParameter 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属性设置为或ValueTypeUndefined设置属性，并将ValueTypeByte该属性设置为数组NumberOfValues中的元素数。

EncoderParameter(Encoder, Byte)

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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 范围包括从 numerator1[i]/分母1[i] 到 numerator2[i]/分母2[i] 的所有小数。

适用于

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

使用指定的EncoderParameter对象和一对 32 位整数初始化类的新实例Encoder。整数对表示一个分数，第一个整数是分子，第二个整数是分母。将 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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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.

注意

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

使用指定的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.")]
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")]
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.")>]
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

[<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

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 值的数据类型。 Type属性ValueType设置为此值。

Value: Int32

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

属性: ObsoleteAttribute

例外

InvalidOperationException

类型无效 EncoderParameterValueType。

适用于

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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 值的数据类型。 Type属性ValueType设置为此值。

value: IntPtr
nativeint

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

适用于

EncoderParameter(Encoder, Int64, Int64)

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

使用指定的EncoderParameter对象和一对 64 位整数初始化类的新实例Encoder。整数对表示整数范围，第一个整数是区域中的最小数字，第二个整数是范围中的最大数字。将 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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

使用指定的EncoderParameter对象和一个 8 位值初始化类的新实例Encoder。将ValueType属性设置为或ValueTypeUndefined将属性设置为 ValueTypeByte 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

如果该true属性设置为 ValueType;否则，该ValueTypeUndefined属性将设置为 ValueType。ValueTypeByte

适用于

EncoderParameter(Encoder, String)

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

使用指定的EncoderParameter对象和字符串初始化类的新实例Encoder。在对象中存储字符串之前，该字符串将转换为以 null 结尾的 EncoderParameter 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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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.jpgc：\的图像文件。

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

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

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

Source:: EncoderParameter.cs

使用指定的EncoderParameter对象和字节数组初始化类的新实例Encoder。将ValueType属性设置为或ValueTypeUndefined设置属性，并将ValueTypeByte该属性设置为数组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

如果该true属性设置为 ValueType;否则，该ValueTypeUndefined属性将设置为 ValueType。ValueTypeByte

适用于

反馈

此页面是否有帮助？