UTF7Encoding.GetString(Byte[], Int32, Int32) Метод

Определение

Пространство имен:

System.Text

Сборка:

mscorlib.dll

Декодирует диапазон байтов из массива байтов в строку.

public:
 override System::String ^ GetString(cli::array <System::Byte> ^ bytes, int index, int count);

[System.Runtime.InteropServices.ComVisible(false)]
public override string GetString(byte[] bytes, int index, int count);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetString : byte[] * int * int -> string

Public Overrides Function GetString (bytes As Byte(), index As Integer, count As Integer) As String

Параметры

bytes

Byte[]

Массив байтов, содержащий последовательность байтов для декодирования.

index

Int32

Индекс первого байта для декодирования.

count

Int32

Количество байтов, которые необходимо декодировать.

Возвращаемое значение

String

Содержит String результаты декодирования указанной последовательности байтов.

Атрибуты

ComVisibleAttribute

Исключения

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

index или count меньше нуля.

–или–

index и count не обозначайте допустимый диапазон в bytes.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе Character Encoding in .NET).

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

Следующий пример кода кодирует строку в массив байтов, а затем декодирует байты обратно в строку.

using System;
using System.Text;

public class SamplesUTF7Encoding  {

   public static void Main()  {

      // Create an instance of UTF7Encoding.
      UTF7Encoding u7 = new UTF7Encoding( true );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string.
      byte[] myBArr = new byte[u7.GetByteCount( myStr )];
      u7.GetBytes( myStr, 0, myStr.Length, myBArr, 0 );

      // Decode the byte array.
      Console.WriteLine( "The new string is: {0}", u7.GetString( myBArr, 0, myBArr.Length ) );
   }
}


/*
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

The new string is: za??

*/

Imports System.Text

Public Class SamplesUTF7Encoding

   Public Shared Sub Main()

      ' Create an instance of UTF7Encoding.
      Dim u7 As New UTF7Encoding(True)

      ' Create byte arrays from the same string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2)

      ' Encode the string.
      Dim myBArr(u7.GetByteCount(myStr)) As Byte
      u7.GetBytes(myStr, 0, myStr.Length, myBArr, 0)

      ' Decode the byte array.
      Console.WriteLine("The new string is: {0}", u7.GetString(myBArr, 0, myBArr.Length))

   End Sub

End Class


'This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.
'
'The new string is: za??ß

Комментарии

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder или Encoder предоставленный GetDecoder методом GetEncoder соответственно.

Note

UTF7Encoding не предоставляет обнаружение ошибок. При обнаружении UTF7Encoding недопустимых байтов обычно выдает недопустимые байты. Если байт больше шестнадцатеричного 0x7F, значение байта равно нулю в символ Юникода, результат хранится в chars массиве, а любая последовательность сдвигов завершается. Например, если байт для кодирования является шестнадцатеричным 0x81, результирующий символ — U+0081. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

См. также раздел

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetDecoder()
• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)