EncoderParameter 建構函式

定義

命名空間:

System.Drawing.Imaging

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

使用指定的 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[])	使用指定的 Encoder 物件和兩個 64 位元整數的陣列，初始化 EncoderParameter 類別的新執行個體。 這兩個陣列表示陣列整數範圍。 設定 ValueType 屬性為 ValueTypeLongRange，並設定 NumberOfValues 屬性為 rangebegin 陣列中的元素數目，這個數目必須和 rangeend 陣列中的元素數目相同。
EncoderParameter(Encoder, Byte, Boolean)	使用指定的 EncoderParameter 物件和一個 8 位元值，初始化 Encoder 類別的新執行個體。 設定 ValueType 屬性為 ValueTypeUndefined 或 ValueTypeByte，並設定 NumberOfValues 屬性為 1。
EncoderParameter(Encoder, String)	使用指定 EncoderParameter 物件和字元字串，初始化 Encoder 類別的新執行個體。 在字串儲存在 EncoderParameter 物件中之前，會先轉換為 Null 終端 ASCII 字串。 設定 ValueType 屬性為 ValueTypeAscii，並設定 NumberOfValues 屬性為包含 null 結束字元 (Terminator) 的 ASCII 字串的長度。
EncoderParameter(Encoder, Int64[])	使用指定的 Encoder 物件和 64 位元整數的陣列，初始化 EncoderParameter 類別的新執行個體。 設定 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)

來源:

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 位元不帶正負號的整數 (Unsigned Integer)，指定儲存在 EncoderParameter 物件中的值。

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

來源:

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)

來源:

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)

來源:

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 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, Int32, Int32, Int32)

來源:

EncoderParameter.cs

警告

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.")]
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

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)

來源:

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)

來源:

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

來源:

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

來源:

EncoderParameter.cs

使用指定的 Encoder 物件和兩個 64 位元整數的陣列，初始化 EncoderParameter 類別的新執行個體。 這兩個陣列表示陣列整數範圍。 設定 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)

來源:

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)

來源:

EncoderParameter.cs

使用指定 EncoderParameter 物件和字元字串，初始化 Encoder 類別的新執行個體。 在字串儲存在 EncoderParameter 物件中之前，會先轉換為 Null 終端 ASCII 字串。 設定 ValueType 屬性為 ValueTypeAscii，並設定 NumberOfValues 屬性為包含 null 結束字元 (Terminator) 的 ASCII 字串的長度。

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

來源:

EncoderParameter.cs

使用指定的 Encoder 物件和 64 位元整數的陣列，初始化 EncoderParameter 類別的新執行個體。 設定 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)

來源:

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 位元整數。

範例

下列程式代碼範例示範如何使用 建構函式建立 EncoderParameterEncoderParameter 。 若要執行此範例，請將程式代碼貼到 Windows Form 中，並從表單的建構函式呼叫 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[])

來源:

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)

來源:

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

來源:

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)

來源:

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。