Decodes a range of bytes in a byte array into a range of characters in a character array.
[Visual Basic] Overrides Public Function GetChars( _ ByVal bytes() As Byte, _ ByVal byteIndex As Integer, _ ByVal byteCount As Integer, _ ByVal chars() As Char, _ ByVal charIndex As Integer _ ) As Integer [C#] public override int GetChars( byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex ); [C++] public: override int GetChars( unsigned char* bytes[], int byteIndex, int byteCount, __wchar_t* chars[], int charIndex ); [JScript] public override function GetChars( bytes : Byte[], byteIndex : int, byteCount : int, chars : Char[], charIndex : int ) : int;
The number of characters stored into the character array.
Exception Type | Condition |
---|---|
ArgumentNullException | The bytes or chars parameter is a null reference (in Visual Basic Nothing). |
ArgumentOutOfRangeException | The byteIndex, byteCount or charIndex parameter is less than zero.
The sum of the byteIndex and byteCount parameters is greater than the length of the byte array. The charIndex parameter is greater than the length of the character array. |
Encoding.BufferOverflow | The the charIndex parameter is equal to the length of the character array.
No bytes have been stored into the byte array. |
This method can be used to determine the exact number of characters that will be produced for a specified range of bytes. Alternatively, GetMaxCharCount can be used to determine the maximum number of characters that will be produced for a specified number of bytes, regardless of the actual byte values.
UTF7Encoding Class | UTF7Encoding Members | System.Text Namespace | GetCharCount | GetMaxCharCount