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

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Text
Assembly:  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.

Exception Condition
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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: