Mono Class Library: System.Text.Encoding Overview | Members

System.Text.Encoding.GetBytes Method

Encodes the specified range of the specified char array into the specified range of the specified byte array.

public abstract int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex)

Parameters

chars
A char array to encode.
charIndex
A int containing the first index of chars to encode.
charCount
A int containing the number of characters to encode.
bytes
A byte array to encode into.
byteIndex
A int containing the first index of bytes to encode into.

Returns

The number of bytes encoded into bytes .

Exceptions

TypeReason
ArgumentExceptionbytes does not contain sufficient space to store the encoded characters.
ArgumentNullException

chars is null.

-or-

bytes is null.

ArgumentOutOfRangeException

charIndex < 0.

-or-

charCount < 0.

-or-

byteIndex < 0.

-or-

(chars.Length - charIndex) < charCount.

-or-

byteIndex > bytes.Length.

Remarks

Operation
As described above.

Note to Inheritors
This method is overridden by types derived from System.Text.Encoding to perform the encoding.

Usage
Encoding.GetByteCount(Char[]) can be used to determine the exact number of bytes that will be produced for a given range of characters. Alternatively, Encoding.GetMaxByteCount(int) can be used to determine the maximum number of bytes that will be produced for a given number of characters, regardless of the actual character values.

Requirements

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0