EncoderParameter Konstruktoren

Definition

Namespace:: System.Drawing.Imaging

Assembly:: System.Drawing.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und Wert.

Überlädt

Name	Beschreibung
EncoderParameter(Encoder, Byte)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer nicht signierten 8-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeByte, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und vier Arrays mit 32-Bit-Ganzzahlen. Die vier Arrays stellen einen rationalen Arraybereich dar. Ein rationaler Bereich ist der Satz aller Bruchzahlen von einem minimalen Bruchwert bis hin zu einem maximalen Bruchwert. Legt die ValueType Eigenschaft auf ValueTypeRationalRangeund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im `numerator1` Array fest, die mit der Anzahl der Elemente in den anderen drei Arrays identisch sein müssen.
EncoderParameter(Encoder, Int32, Int32, Int32, Int32)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und vier, 32-Bit-Ganzzahlen. Die vier ganzen Zahlen stellen einen Bereich von Bruchzahlen dar. Die ersten beiden ganzzahligen Zahlen stellen den kleinsten Bruch im Bereich dar, und die verbleibenden zwei ganzzahligen Zahlen stellen den größten Bruchteil im Bereich dar. Legt die ValueType Eigenschaft auf ValueTypeRationalRange, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32, Int32)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 32-Bit-Ganzzahlpaar. Das Ganzzahlpaar stellt einen Bruch dar, die erste ganze Zahl als Zähler und die zweite ganze Zahl, die den Nenner darstellt. Legt die ValueType Eigenschaft auf ValueTypeRational, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32, Int32, Int32)	Veraltet. Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und drei ganzzahligen Zahlen, die die Anzahl der Werte, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter Objekt gespeicherten Werte angeben.
EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt, der Anzahl der Werte, dem Datentyp der Werte und einem Zeiger auf die im EncoderParameter Objekt gespeicherten Werte.
EncoderParameter(Encoder, Int64, Int64)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 64-Bit-Ganzzahlpaar. Das Ganzzahlpaar stellt einen Ganzzahlbereich dar, die erste ganze Zahl, die kleinste Zahl im Bereich und die zweite ganze Zahl, die die größte Zahl im Bereich ist. Legt die ValueType Eigenschaft auf ValueTypeLongRange, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32[], Int32[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und zwei Arrays von 32-Bit-Ganzzahlen. Die beiden Arrays stellen ein Array von Bruchzahlen dar. Legt die ValueType Eigenschaft auf ValueTypeRationalund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im `numerator` Array fest, die mit der Anzahl der Elemente im `denominator` Array identisch sein müssen.
EncoderParameter(Encoder, Int64[], Int64[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und zwei Arrays mit 64-Bit-Ganzzahlen. Die beiden Arrays stellen einen Array-Ganzzahlbereich dar. Legt die ValueType Eigenschaft auf ValueTypeLongRangeund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im `rangebegin` Array fest, die mit der Anzahl der Elemente im `rangeend` Array identisch sein müssen.
EncoderParameter(Encoder, Byte, Boolean)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 8-Bit-Wert. Legt die ValueType Eigenschaft auf ValueTypeUndefined oder ValueTypeByte, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, String)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer Zeichenfolge. Die Zeichenfolge wird in eine MIT NULL beendete ASCII-Zeichenfolge konvertiert, bevor sie im EncoderParameter Objekt gespeichert wird. Legt die ValueType Eigenschaft auf ValueTypeAscii, und legt die NumberOfValues Eigenschaft auf die Länge der ASCII-Zeichenfolge einschließlich des NULL-Terminators fest.
EncoderParameter(Encoder, Int64[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array mit 64-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeLong (32-Bit) fest und legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Int64)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer 64-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeLong (32 Bit) fest und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int16[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array mit 16-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeShortund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Int16)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer 16-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeShort, und legt die NumberOfValues Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Byte[])	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array von nicht signierten 8-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeByteund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Byte[], Boolean)	Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Bytearray. Legt die ValueType Eigenschaft auf ValueTypeUndefined oder ValueTypeByte, und legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.

EncoderParameter(Encoder, Byte)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer nicht signierten 8-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeByte, und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Byte

Eine 8-Bit-ganzzahl ohne Vorzeichen, die den im EncoderParameter Objekt gespeicherten Wert angibt.

Gilt für:

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

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und vier Arrays mit 32-Bit-Ganzzahlen. Die vier Arrays stellen einen rationalen Arraybereich dar. Ein rationaler Bereich ist der Satz aller Bruchzahlen von einem minimalen Bruchwert bis hin zu einem maximalen Bruchwert. Legt die ValueType Eigenschaft auf ValueTypeRationalRangeund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im numerator1 Array fest, die mit der Anzahl der Elemente in den anderen drei Arrays identisch sein müssen.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator1: Int32[]

Ein Array mit 32-Bit-Ganzzahlen, die die Zähler der Mindestwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein.

denominator1: Int32[]

Ein Array von 32-Bit-Ganzzahlen, die die Nenner der Mindestwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein.

numerator2: Int32[]

Ein Array von 32-Bit-Ganzzahlen, die die Zähler der Maximalwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein.

denominator2: Int32[]

Ein Array von 32-Bit-Ganzzahlen, die die Nenner der Maximalwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein.

Hinweise

Der Kursbereich besteht aus allen Dezimalzahlen von Zähler1[i]/Nennerator1[i] bis Zähler2[i]/Nennerator2[i].

Gilt für:

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

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und vier, 32-Bit-Ganzzahlen. Die vier ganzen Zahlen stellen einen Bereich von Bruchzahlen dar. Die ersten beiden ganzzahligen Zahlen stellen den kleinsten Bruch im Bereich dar, und die verbleibenden zwei ganzzahligen Zahlen stellen den größten Bruchteil im Bereich dar. Legt die ValueType Eigenschaft auf ValueTypeRationalRange, und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator1: Int32

Eine 32-Bit-Ganzzahl, die den Zähler des kleinsten Bruchteils im Bereich darstellt. Muss nichtegativ sein.

demoninator1: Int32

Eine 32-Bit-Ganzzahl, die den Nenner des kleinsten Bruchteils im Bereich darstellt. Muss nichtegativ sein.

numerator2: Int32

Eine 32-Bit-Ganzzahl, die den Nenner des kleinsten Bruchteils im Bereich darstellt. Muss nichtegativ sein.

demoninator2: Int32

Eine 32-Bit-Ganzzahl, die den Zähler des größten Bruchs im Bereich darstellt. Muss nichtegativ sein.

Gilt für:

EncoderParameter(Encoder, Int32, Int32)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 32-Bit-Ganzzahlpaar. Das Ganzzahlpaar stellt einen Bruch dar, die erste ganze Zahl als Zähler und die zweite ganze Zahl, die den Nenner darstellt. Legt die ValueType Eigenschaft auf ValueTypeRational, und legt die NumberOfValues Eigenschaft auf 1 fest.

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

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

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numerator As Integer, demoninator As Integer)

Public Sub New (encoder As Encoder, numerator As Integer, denominator As Integer)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator: Int32

Eine 32-Bit-Ganzzahl, die den Zähler eines Bruchs darstellt. Muss nichtegativ sein.

demoninatordenominator: Int32

Eine 32-Bit-Ganzzahl, die den Nenner eines Bruchs darstellt. Muss nichtegativ sein.

Gilt für:

EncoderParameter(Encoder, Int32, Int32, Int32)

Achtung

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

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und drei ganzzahligen Zahlen, die die Anzahl der Werte, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter Objekt gespeicherten Werte angeben.

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

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

Public Sub New (encoder As Encoder, NumberOfValues As Integer, Type As Integer, Value As Integer)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

NumberOfValues: Int32

Eine ganze Zahl, die die Anzahl der im EncoderParameter Objekt gespeicherten Werte angibt. Die NumberOfValues Eigenschaft wird auf diesen Wert festgelegt.

Type: Int32

Ein Element der EncoderParameterValueType Aufzählung, das den Datentyp der im EncoderParameter Objekt gespeicherten Werte angibt. Die Eigenschaften und ValueType Eigenschaften Type werden auf diesen Wert festgelegt.

Value: Int32

Ein Zeiger auf ein Array von Werten des Typs, der durch den Type Parameter angegeben wird.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Der Typ ist kein gültiger EncoderParameterValueTypeTyp.

Gilt für:

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt, der Anzahl der Werte, dem Datentyp der Werte und einem Zeiger auf die im EncoderParameter Objekt gespeicherten Werte.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numberValues: Int32

Eine ganze Zahl, die die Anzahl der im EncoderParameter Objekt gespeicherten Werte angibt. Die NumberOfValues Eigenschaft wird auf diesen Wert festgelegt.

type: EncoderParameterValueType

value: IntPtr
nativeint

Ein Zeiger auf ein Array von Werten des Typs, der durch den type Parameter angegeben wird.

Gilt für:

EncoderParameter(Encoder, Int64, Int64)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 64-Bit-Ganzzahlpaar. Das Ganzzahlpaar stellt einen Ganzzahlbereich dar, die erste ganze Zahl, die kleinste Zahl im Bereich und die zweite ganze Zahl, die die größte Zahl im Bereich ist. Legt die ValueType Eigenschaft auf ValueTypeLongRange, und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

rangebegin: Int64

Eine 64-Bit-Ganzzahl, die die kleinste Zahl in einem Ganzzahlbereich darstellt. Muss nichtegativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter Objekt gespeichert wird.

rangeend: Int64

Eine 64-Bit-Ganzzahl, die die größte Zahl in einem Ganzzahlbereich darstellt. Muss nichtegativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter Objekt gespeichert wird.

Gilt für:

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

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und zwei Arrays von 32-Bit-Ganzzahlen. Die beiden Arrays stellen ein Array von Bruchzahlen dar. Legt die ValueType Eigenschaft auf ValueTypeRationalund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im numerator Array fest, die mit der Anzahl der Elemente im denominator Array identisch sein müssen.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator: Int32[]

Ein Array von 32-Bit-Ganzzahlen, die die Zähler der Bruchzahlen angibt. Die ganzen Zahlen im Array müssen nicht negativ sein.

denominator: Int32[]

Ein Array von 32-Bit-Ganzzahlen, die die Nenner der Bruchzahlen angibt. Die ganzen Zahlen im Array müssen nicht negativ sein. Ein Nenner eines bestimmten Indexes wird mit dem Zähler desselben Indexes gekoppelt.

Gilt für:

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

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und zwei Arrays mit 64-Bit-Ganzzahlen. Die beiden Arrays stellen einen Array-Ganzzahlbereich dar. Legt die ValueType Eigenschaft auf ValueTypeLongRangeund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im rangebegin Array fest, die mit der Anzahl der Elemente im rangeend Array identisch sein müssen.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

rangebegin: Int64[]

Ein Array von 64-Bit-Ganzzahlen, die die Mindestwerte für die ganzzahligen Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameter Objekt gespeichert werden.

rangeend: Int64[]

Ein Array mit ganzzahligen 64-Bit-Zahlen, die die Maximalwerte für die ganzzahligen Bereiche angibt. Die ganzen Zahlen im Array müssen nicht negativ sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameters Objekt gespeichert werden. Ein Maximalwert eines bestimmten Indexes wird mit dem Minimalwert desselben Indexes gekoppelt.

Gilt für:

EncoderParameter(Encoder, Byte, Boolean)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem 8-Bit-Wert. Legt die ValueType Eigenschaft auf ValueTypeUndefined oder ValueTypeByte, und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Byte

Ein Byte, das den im EncoderParameter Objekt gespeicherten Wert angibt.

undefined: Boolean

Wenn truedie Eigenschaft auf ValueTypeUndefined; festgelegt ist, andernfalls wird die ValueType Eigenschaft auf ValueTypeByte ValueType .

Gilt für:

EncoderParameter(Encoder, String)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer Zeichenfolge. Die Zeichenfolge wird in eine MIT NULL beendete ASCII-Zeichenfolge konvertiert, bevor sie im EncoderParameter Objekt gespeichert wird. Legt die ValueType Eigenschaft auf ValueTypeAscii, und legt die NumberOfValues Eigenschaft auf die Länge der ASCII-Zeichenfolge einschließlich des NULL-Terminators fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: String

Ein String Wert, der den im EncoderParameter Objekt gespeicherten Wert angibt.

Gilt für:

EncoderParameter(Encoder, Int64[])

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array mit 64-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeLong (32-Bit) fest und legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Int64[]

Ein Array von 64-Bit-Ganzzahlen, die die im EncoderParameter Objekt gespeicherten Werte angeben. Die ganzen Zahlen im Array müssen nicht negativ sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameter Objekt gespeichert werden.

Gilt für:

EncoderParameter(Encoder, Int64)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer 64-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeLong (32 Bit) fest und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Int64

Eine 64-Bit-Ganzzahl, die den im EncoderParameter Objekt gespeicherten Wert angibt. Muss nichtegativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter Objekt gespeichert wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen EncoderParameter mit dem Konstruktor EncoderParameter erstellen. Zum Ausführen dieses Beispiels fügen Sie den Code in ein Windows Form-Formular ein, und rufen Sie die VaryQualityLevel Methode aus dem Konstruktor des Formulars auf. In diesem Beispiel ist eine Bilddatei mit dem Namen TestPhoto.jpg"c:\" erforderlich.

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

Gilt für:

EncoderParameter(Encoder, Int16[])

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array mit 16-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeShortund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Int16[]

Ein Array von 16-Bit-Ganzzahlen, die die im EncoderParameter Objekt gespeicherten Werte angeben. Die ganzen Zahlen im Array müssen nicht negativ sein.

Gilt für:

EncoderParameter(Encoder, Int16)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einer 16-Bit-Ganzzahl. Legt die ValueType Eigenschaft auf ValueTypeShort, und legt die NumberOfValues Eigenschaft auf 1 fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Int16

Eine 16-Bit-Ganzzahl, die den im EncoderParameter Objekt gespeicherten Wert angibt. Muss nichtegativ sein.

Gilt für:

EncoderParameter(Encoder, Byte[])

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Array von nicht signierten 8-Bit-Ganzzahlen. Legt die ValueType Eigenschaft auf ValueTypeByteund legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.

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

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Byte[]

Ein Array von 8-Bit-ganzzahlen ohne Vorzeichen, die die im EncoderParameter Objekt gespeicherten Werte angeben.

Gilt für:

EncoderParameter(Encoder, Byte[], Boolean)

Initialisiert eine neue Instanz der EncoderParameter Klasse mit dem angegebenen Encoder Objekt und einem Bytearray. Legt die ValueType Eigenschaft auf ValueTypeUndefined oder ValueTypeByte, und legt die NumberOfValues Eigenschaft auf die Anzahl der Elemente im Array fest.

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)

Parameter

encoder: Encoder

Ein Encoder Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value: Byte[]

Ein Bytearray, das die im EncoderParameter Objekt gespeicherten Werte angibt.

undefined: Boolean

Wenn truedie Eigenschaft auf ValueTypeUndefined; festgelegt ist, andernfalls wird die ValueType Eigenschaft auf ValueTypeByte ValueType .

Gilt für:

Feedback

War diese Seite hilfreich?