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

Определение

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

System.Text

Сборка:

System.Text.Encoding.Extensions.dll

Исходный код:

UTF8Encoding.cs

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

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

public override string GetString (byte[] bytes, int index, int count);

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, содержащий результаты декодирования заданной последовательности байтов.

Исключения

ArgumentNullException

bytes имеет значение null.

ArgumentOutOfRangeException

Значение параметра index или count меньше нуля.

-или-

Параметры index и count не указывают допустимый диапазон в bytes.

ArgumentException

Обнаружение ошибок включено, и параметр bytes содержит недопустимую последовательность байтов.

DecoderFallbackException

Произошел откат (см. сведения о кодировке символов в .NET)

- и -

Параметру DecoderFallback задается значение DecoderExceptionFallback.

Примеры

В следующем примере выполняется инициализация массива путем вызова GetByteCount метода , чтобы точно определить, сколько байтов требуется для закодированной строки, а затем добавляется размер метки порядка байтов (BOM). Затем в этом примере вызывается GetPreamble метод для хранения BOM в массиве перед вызовом GetBytes метода для хранения закодированных байтов в массиве. Затем в примере вызывается GetString метод для декодирования строки.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      UTF8Encoding utf8 = new UTF8Encoding(true, true);

      String s = "It was the best of times, it was the worst of times...";

      // We need to dimension the array, since we'll populate it with 2 method calls.
      Byte[] bytes = new Byte[utf8.GetByteCount(s) + utf8.GetPreamble().Length];
      // Encode the string.
      Array.Copy(utf8.GetPreamble(), bytes, utf8.GetPreamble().Length);
      utf8.GetBytes(s, 0, s.Length, bytes, utf8.GetPreamble().Length);

      // Decode the byte array.
      String s2 = utf8.GetString(bytes, 0, bytes.Length);
      Console.WriteLine(s2);
   }
}
// The example displays the following output:
//        ?It was the best of times, it was the worst of times...

Imports System.Text

Module Example
   Public Sub Main()
      Dim utf8 As New UTF8Encoding(True, True)

      Dim s As String = "It was the best of times, it was the worst of times..."

      ' We need to dimension the array, since we'll populate it with 2 method calls.
      Dim bytes(utf8.GetByteCount(s) + utf8.GetPreamble().Length - 1) As Byte
      ' Encode the string.
      Array.Copy(utf8.GetPreamble(), bytes, utf8.GetPreamble().Length)
      utf8.GetBytes(s, 0, s.Length, bytes, utf8.GetPreamble().Length)

      ' Decode the byte array.
      Dim s2 As String = utf8.GetString(bytes, 0, bytes.Length)
      Console.WriteLine(s2)
   End Sub
End Module
' The example displays the following output:
'       ?It was the best of times, it was the worst of times...

Обратите внимание, что в этом случае декодированная строка отличается от исходной, так как она начинается с 16-разрядной метки порядка байтов U+FFFD. Это означает, что две строки будут сравниваться как неравные, и если строка выводится, метка метки будет отображаться в качестве замещающего символа "?". Чтобы удалить метку метки в начале строки, можно вызвать String.TrimStart метод .

Комментарии

При обнаружении ошибок недопустимая последовательность приводит к тому, что этот метод создает ArgumentException исключение. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не создается.

Если диапазон декодированных байтов включает метку порядка байтов (BOM), а массив байтов был возвращен методом типа, не поддерживающего BOM, символ U+FFFE включается в массив символов, возвращаемый этим методом. Его можно удалить, вызвав String.TrimStart метод .

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

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

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