EncoderParameter Construtores

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um valor.

Sobrecargas

EncoderParameter(Encoder, Byte)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro sem sinal de 8 bits. Define a propriedade ValueType como ValueTypeByte e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e quatro matrizes de inteiros de 32 bits. As quatro matrizes representam intervalos racionais de uma matriz. Um intervalo razoável é o conjunto de todas as frações de um valor fracionário mínimo até um valor fracionário máximo. Define a propriedade ValueType como ValueTypeRationalRange e a propriedade NumberOfValues como o número de elementos na matriz numerator1, que deve ser igual ao número de elementos nas outras três matrizes.
EncoderParameter(Encoder, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e quatro inteiros de 32 bits. Os quatro inteiros representam um intervalo de frações. Os primeiros dois inteiros representam a menor fração no intervalo e os dois inteiros restantes representam a maior fração no intervalo. Define a propriedade ValueType como ValueTypeRationalRange e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Int32, Int32)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um par de inteiros de 32 bits. O par de números inteiros representa uma fração, o primeiro inteiro sendo o numerador e o segundo inteiro sendo o denominador. Define a propriedade ValueType como ValueTypeRational e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Int32, Int32, Int32)	Obsoleto. Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e três inteiros que especificam o número de valores, o tipo de dados dos valores e um ponteiro para os valores armazenados non objeto EncoderParameter.
EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado, o número de valores, o tipo de dados dos valores e um ponteiro para os valores armazenados no objeto EncoderParameter.
EncoderParameter(Encoder, Int64, Int64)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um par de inteiros de 64 bits. O par de inteiros representa um intervalo de inteiros, o primeiro inteiro sendo o menor número no intervalo e o segundo inteiro sendo o maior número no intervalo. Define a propriedade ValueType como ValueTypeLongRange e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Int32[], Int32[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e duas matrizes de inteiros de 32 bits. As duas matrizes representam uma matriz de frações. Define a propriedade ValueType como ValueTypeRational e a propriedade NumberOfValues como o número de elementos na matriz numerator, que deve ser igual ao número de elementos na matriz denominator.
EncoderParameter(Encoder, Int64[], Int64[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e duas matrizes de inteiros de 64 bits. As duas matrizes representam uma matriz de intervalos de inteiros. Define a propriedade ValueType como ValueTypeLongRange e a propriedade NumberOfValues como o número de elementos na matriz rangebegin, que deve ser igual ao número de elementos na matriz rangeend.
EncoderParameter(Encoder, Byte, Boolean)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um valor de 8 bits. Define a propriedade ValueType como ValueTypeUndefined ou ValueTypeByte e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, String)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma cadeia de caracteres. A cadeia de caracteres é convertida em uma cadeia de caracteres ASCII terminada em nulo antes de ser armazenada no objeto EncoderParameter. Define a propriedade ValueType como ValueTypeAscii e define a propriedade NumberOfValues para o comprimento da cadeia de caracteres ASCII incluindo o terminador NULL.
EncoderParameter(Encoder, Int64[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de 64 bits. Define a propriedade ValueType como ValueTypeLong e define a propriedade NumberOfValues (32 bits) para o número de elementos na matriz.
EncoderParameter(Encoder, Int64)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro de 64 bits. Define a propriedade ValueType como ValueTypeLong (32 bits) e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Int16[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de 16 bits. Define a propriedade ValueType como ValueTypeShort e define a propriedade NumberOfValues para o número de elementos na matriz.
EncoderParameter(Encoder, Int16)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro de 16 bits. Define a propriedade ValueType como ValueTypeShort e a propriedade NumberOfValues como 1.
EncoderParameter(Encoder, Byte[])	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros sem sinal de 8 bits. Define a propriedade ValueType como ValueTypeByte e define a propriedade NumberOfValues para o número de elementos na matriz.
EncoderParameter(Encoder, Byte[], Boolean)	Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de bytes. Define a propriedade ValueType como ValueTypeUndefined ou ValueTypeByte e define a propriedade NumberOfValues para o número de elementos na matriz.

EncoderParameter(Encoder, Byte)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro sem sinal de 8 bits. Define a propriedade ValueType como ValueTypeByte e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Byte

Um inteiro sem sinal de 8 bits que especifica o valor armazenado no objeto EncoderParameter.

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

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e quatro matrizes de inteiros de 32 bits. As quatro matrizes representam intervalos racionais de uma matriz. Um intervalo razoável é o conjunto de todas as frações de um valor fracionário mínimo até um valor fracionário máximo. Define a propriedade ValueType como ValueTypeRationalRange e a propriedade NumberOfValues como o número de elementos na matriz numerator1, que deve ser igual ao número de elementos nas outras três matrizes.

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

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

numerator1

Int32[]

Uma matriz de inteiros de 32 bits que especifica os numeradores de valores mínimos para os intervalos. Os inteiros na matriz devem ser não negativos.

denominator1

Int32[]

Uma matriz de inteiros de 32 bits que especifica os denominadores de valores mínimos para os intervalos. Os inteiros na matriz devem ser não negativos.

numerator2

Int32[]

Uma matriz de inteiros de 32 bits que especifica os numeradores de valores máximos para os intervalos. Os inteiros na matriz devem ser não negativos.

denominator2

Int32[]

Uma matriz de inteiros de 32 bits que especifica os denominadores de valores máximos para os intervalos. Os inteiros na matriz devem ser não negativos.

Comentários

O intervalo ith consiste em todos os números fracionários de numerador1[i]/denominator1[i] até numerator2[i]/denominator2[i].

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

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e quatro inteiros de 32 bits. Os quatro inteiros representam um intervalo de frações. Os primeiros dois inteiros representam a menor fração no intervalo e os dois inteiros restantes representam a maior fração no intervalo. Define a propriedade ValueType como ValueTypeRationalRange e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

numerator1

Int32

Um inteiro de 32 bits que representa o numerador da menor fração no intervalo. Deve ser não negativo.

demoninator1

Int32

Um inteiro de 32 bits que representa o denominador da menor fração no intervalo. Deve ser não negativo.

numerator2

Int32

Um inteiro de 32 bits que representa o denominador da menor fração no intervalo. Deve ser não negativo.

demoninator2

Int32

Um inteiro de 32 bits que representa o numerador da maior fração no intervalo. Deve ser não negativo.

EncoderParameter(Encoder, Int32, Int32)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um par de inteiros de 32 bits. O par de números inteiros representa uma fração, o primeiro inteiro sendo o numerador e o segundo inteiro sendo o denominador. Define a propriedade ValueType como ValueTypeRational e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

numerator

Int32

Um inteiro de 32 bits que representa o numerador de uma fração. Deve ser não negativo.

denominator

Int32

Um inteiro de 32 bits que representa o denominador de uma fração. Deve ser não negativo.

EncoderParameter(Encoder, Int32, Int32, Int32)

Origem:

EncoderParameter.cs

Cuidado

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

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e três inteiros que especificam o número de valores, o tipo de dados dos valores e um ponteiro para os valores armazenados non objeto 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

NumberOfValues

Int32

Um inteiro que especifica o número de valores armazenados no objeto EncoderParameter. A propriedade NumberOfValues é definida para esse valor.

Type

Int32

Um membro da enumeração EncoderParameterValueType que especifica o tipo de dados dos valores armazenados no objeto EncoderParameter. As propriedades Type e ValueType estão definidas para esse valor.

Value

Int32

Um ponteiro para uma matriz de valores do tipo especificado pelo parâmetro Type.

Atributos

ObsoleteAttribute

Exceções

InvalidOperationException

O tipo não é um EncoderParameterValueType válido.

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado, o número de valores, o tipo de dados dos valores e um ponteiro para os valores armazenados no objeto 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

numberValues

Int32

Um inteiro que especifica o número de valores armazenados no objeto EncoderParameter. A propriedade NumberOfValues é definida para esse valor.

type

EncoderParameterValueType

Um membro da enumeração EncoderParameterValueType que especifica o tipo de dados dos valores armazenados no objeto EncoderParameter. As propriedades Type e ValueType estão definidas para esse valor.

value

IntPtr

nativeint

Um ponteiro para uma matriz de valores do tipo especificado pelo parâmetro Type.

EncoderParameter(Encoder, Int64, Int64)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um par de inteiros de 64 bits. O par de inteiros representa um intervalo de inteiros, o primeiro inteiro sendo o menor número no intervalo e o segundo inteiro sendo o maior número no intervalo. Define a propriedade ValueType como ValueTypeLongRange e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

rangebegin

Int64

Um inteiro de 64 bits que representa o menor número em um intervalo de inteiros. Deve ser não negativo. Esse parâmetro é convertido em um inteiro de 32 bits antes de ser armazenado no objeto EncoderParameter.

rangeend

Int64

Um inteiro de 64 bits que representa o maior número em um intervalo de inteiros. Deve ser não negativo. Esse parâmetro é convertido em um inteiro de 32 bits antes de ser armazenado no objeto EncoderParameter.

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

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e duas matrizes de inteiros de 32 bits. As duas matrizes representam uma matriz de frações. Define a propriedade ValueType como ValueTypeRational e a propriedade NumberOfValues como o número de elementos na matriz numerator, que deve ser igual ao número de elementos na matriz 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())

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

numerator

Int32[]

Uma matriz de inteiros de 32 bits que especifica os numeradores das frações. Os inteiros na matriz devem ser não negativos.

denominator

Int32[]

Uma matriz de inteiros de 32 bits que especifica os denominadores das frações. Os inteiros na matriz devem ser não negativos. Um denominador de um determinado índice é emparelhado com o numerador do mesmo índice.

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

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e duas matrizes de inteiros de 64 bits. As duas matrizes representam uma matriz de intervalos de inteiros. Define a propriedade ValueType como ValueTypeLongRange e a propriedade NumberOfValues como o número de elementos na matriz rangebegin, que deve ser igual ao número de elementos na matriz 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())

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

rangebegin

Int64[]

Uma matriz de inteiros de 64 bits que especifica os valores mínimos para os intervalos de inteiros. Os inteiros na matriz devem ser não negativos. Os inteiros de 64 bits são convertidos em inteiros de 32 bits antes de serem armazenadas no objeto EncoderParameter.

rangeend

Int64[]

Uma matriz de inteiros de 64 bits que especifica os valores máximos para os intervalos de inteiros. Os inteiros na matriz devem ser não negativos. Os inteiros de 64 bits são convertidos em inteiros de 32 bits antes de serem armazenadas no objeto EncoderParameters. Um valor máximo de um determinado índice é emparelhado com o valor mínimo do mesmo índice.

EncoderParameter(Encoder, Byte, Boolean)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um valor de 8 bits. Define a propriedade ValueType como ValueTypeUndefined ou ValueTypeByte e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Byte

Um byte que especifica o valor armazenado no objeto EncoderParameter.

undefined

Boolean

Se true, a propriedade ValueType será definida como ValueTypeUndefined, caso contrário, a propriedade ValueType será definida como ValueTypeByte.

EncoderParameter(Encoder, String)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma cadeia de caracteres. A cadeia de caracteres é convertida em uma cadeia de caracteres ASCII terminada em nulo antes de ser armazenada no objeto EncoderParameter. Define a propriedade ValueType como ValueTypeAscii e define a propriedade NumberOfValues para o comprimento da cadeia de caracteres ASCII incluindo o terminador 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

String

Um EncoderParameter que especifica o valor armazenado no objeto String.

EncoderParameter(Encoder, Int64[])

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de 64 bits. Define a propriedade ValueType como ValueTypeLong e define a propriedade NumberOfValues (32 bits) para o número de elementos na matriz.

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

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Int64[]

Uma matriz de inteiros de 64 bits que especifica os valores armazenados no objeto EncoderParameter. Os inteiros na matriz devem ser não negativos. Os inteiros de 64 bits são convertidos em inteiros de 32 bits antes de serem armazenadas no objeto EncoderParameter.

EncoderParameter(Encoder, Int64)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro de 64 bits. Define a propriedade ValueType como ValueTypeLong (32 bits) e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Int64

Um inteiro de 64 bits que especifica o valor armazenado no objeto EncoderParameter. Deve ser não negativo. Esse parâmetro é convertido em um inteiro de 32 bits antes de ser armazenado no objeto EncoderParameter.

Exemplos

O exemplo de código a seguir demonstra como criar um EncoderParameter usando o EncoderParameter construtor . Para executar este exemplo, cole o código em um Windows Form e chame o VaryQualityLevel método do construtor do formulário. Este exemplo requer um arquivo de imagem chamado TestPhoto.jpg localizado em 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[])

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de 16 bits. Define a propriedade ValueType como ValueTypeShort e define a propriedade NumberOfValues para o número de elementos na matriz.

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

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Int16[]

Uma matriz de inteiros de 16 bits que especifica os valores armazenados no objeto EncoderParameter. Os inteiros na matriz devem ser não negativos.

EncoderParameter(Encoder, Int16)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e um inteiro de 16 bits. Define a propriedade ValueType como ValueTypeShort e a propriedade NumberOfValues como 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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Int16

Um inteiro de 16 bits que especifica o valor armazenado no objeto EncoderParameter. Deve ser não negativo.

EncoderParameter(Encoder, Byte[])

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros sem sinal de 8 bits. Define a propriedade ValueType como ValueTypeByte e define a propriedade NumberOfValues para o número de elementos na matriz.

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

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Byte[]

Uma matriz de inteiros sem sinal de 8 bits que especifica os valores armazenados no objeto EncoderParameter.

EncoderParameter(Encoder, Byte[], Boolean)

Origem:

EncoderParameter.cs

Inicializa uma nova instância da classe EncoderParameter com o objeto Encoder especificado e uma matriz de inteiros de bytes. Define a propriedade ValueType como ValueTypeUndefined ou ValueTypeByte e define a propriedade NumberOfValues para o número de elementos na matriz.

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)

Parâmetros

encoder

Encoder

Um objeto Encoder que encapsula o identificador global exclusivo da categoria de parâmetro.

value

Byte[]

Uma matriz de bytes que especifica os valores armazenados no objeto EncoderParameter.

undefined

Boolean

Se true, a propriedade ValueType será definida como ValueTypeUndefined, caso contrário, a propriedade ValueType será definida como ValueTypeByte.