Encoding.Convert Method (Encoding, Encoding, Byte[], Int32, Int32)

Converts a range of bytes in a byte array from one encoding to another.

Namespace:  System.Text
Assemblies:   System.Text.Encoding (in System.Text.Encoding.dll)
  mscorlib (in mscorlib.dll)

public static byte[] Convert(
	Encoding srcEncoding,
	Encoding dstEncoding,
	byte[] bytes,
	int index,
	int count
)

Parameters

srcEncoding
Type: System.Text.Encoding

The encoding of the source array, bytes.

dstEncoding
Type: System.Text.Encoding

The encoding of the output array.

bytes
Type: System.Byte[]

The array of bytes to convert.

index
Type: System.Int32

The index of the first element of bytes to convert.

count
Type: System.Int32

The number of bytes to convert.

Return Value

Type: System.Byte[]
An array of type Byte containing the result of converting a range of bytes in bytes from srcEncoding to dstEncoding.

ExceptionCondition
ArgumentNullException

srcEncoding is null.

-or-

dstEncoding is null.

-or-

bytes is null.

ArgumentOutOfRangeException

index and count do not specify a valid range in the byte array.

DecoderFallbackException

A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)

-and-

srcEncoding.DecoderFallback is set to DecoderExceptionFallback.

EncoderFallbackException

A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)

-and-

dstEncoding.EncoderFallback is set to EncoderExceptionFallback.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft