System.Text.ASCIIEncoding.GetByteCount Method

Calculates the number of bytes produced by encoding a set of characters from the specified character array.

Syntax

public override int GetByteCount (char[] chars, int index, int count)

Parameters

chars
The character array containing the set of characters to encode.
index
The index of the first character to encode.
count
The number of characters to encode.

Returns

The number of bytes produced by encoding the specified characters.

Exceptions

TypeReason
ArgumentNullException chars is null.
ArgumentOutOfRangeException

index < 0.

-or-

count < 0.

-or-

index and count do not specify a valid range in chars (i.e. ( index + count - 1) > chars.Length).

Remarks

To calculate the exact array size required by ASCIIEncoding.GetBytes(string, int, int, Byte[], int) to store the resulting bytes, the application uses ASCIIEncoding.GetByteCount(Char[], int, int). To calculate the maximum array size, the application should use ASCIIEncoding.GetMaxByteCount(int). The ASCIIEncoding.GetByteCount(Char[], int, int) method generally allows allocation of less memory, while the ASCIIEncoding.GetMaxByteCount(int) method generally executes faster.

Requirements

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