Article
11/18/2011

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

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: 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.

count
Type: System.Int32
The number 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.

Partager via