• Article

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

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

Namespace:  System.Text
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function Convert ( _
    srcEncoding As Encoding, _
    dstEncoding As Encoding, _
    bytes As Byte(), _
    index As Integer, _
    count As Integer _
) As Byte()

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

Parameters

  • bytes
    Type: array<System.Byte[]
    The array of bytes to convert.
  • index
    Type: System.Int32
    The zero-based index of the first element of bytes to convert.

Return Value

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

Exceptions

Exception Condition
ArgumentNullException

srcEncoding is nulla null reference (Nothing in Visual Basic).

-or-

dstEncoding is nulla null reference (Nothing in Visual Basic).

-or-

bytes is nulla null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException

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

A fallback occurred (see Understanding Encodings for complete explanation).
EncoderFallbackException

A fallback occurred (see Understanding Encodings for complete explanation).

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.