UnicodeEncoding.GetByteCount Метод

Ссылка

Определение

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

Сборка:: System.Text.Encoding.Extensions.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

GetByteCount(String)	Вычисляет количество байтов, полученных при кодировании символов в указанной строке.
GetByteCount(Char*, Int32)	Вычисляет число байтов, полученных при кодировании набора символов начиная с заданного указателя символа.
GetByteCount(Char[], Int32, Int32)	Вычисляет число байтов, полученных при кодировании набора символов из указанного массива символов.

GetByteCount(String)

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Вычисляет количество байтов, полученных при кодировании символов в указанной строке.

public:
 override int GetByteCount(System::String ^ s);

public override int GetByteCount (string s);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (s As String) As Integer

Параметры

s: String

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

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

Int32

Число байтов, полученных при кодировании заданных символов.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Результирующее число байтов больше максимального количества, которое можно вернуть как целочисленное значение.

ArgumentException

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

EncoderFallbackException

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

- и -

Параметру EncoderFallback задается значение EncoderExceptionFallback.

Примеры

В следующем примере вызывается GetMaxByteCount метод и GetByteCount(String) для вычисления максимального и фактического количества байтов, необходимых для кодирования строки. Также отображается фактическое количество байтов, необходимых для хранения потока байтов с меткой порядка байтов.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        String chars = "UTF-16 Encoding Example";
        Encoding unicode = Encoding.Unicode;

        Console.WriteLine("Bytes needed to encode '{0}':", chars);
        Console.WriteLine("   Maximum:         {0}",
                          unicode.GetMaxByteCount(chars.Length));
        Console.WriteLine("   Actual:          {0}",
                          unicode.GetByteCount(chars));
        Console.WriteLine("   Actual with BOM: {0}",
                          unicode.GetByteCount(chars) + unicode.GetPreamble().Length);
    }
}
// The example displays the following output:
//       Bytes needed to encode 'UTF-16 Encoding Example':
//          Maximum:         48
//          Actual:          46
//          Actual with BOM: 48

Imports System.Text

Module Example
    Public Sub Main()
        Dim chars As String = "UTF-16 Encoding Example"
        Dim unicode As Encoding = Encoding.Unicode

        Console.WriteLine("Bytes needed to encode '{0}':", chars)
        Console.WriteLine("   Maximum:         {0}",
                          unicode.GetMaxByteCount(chars.Length))
        Console.WriteLine("   Actual:          {0}",
                          unicode.GetByteCount(chars))
        Console.WriteLine("   Actual with BOM: {0}",
                          unicode.GetByteCount(chars) + unicode.GetPreamble().Length)
    End Sub
End Module
' The example displays the following output:
'       Bytes needed to encode 'UTF-16 Encoding Example':
'          Maximum:         48
'          Actual:          46
'          Actual with BOM: 48

Чтобы вычислить точный размер массива, необходимый GetBytes для хранения результирующего байта, вызовите GetByteCount метод . Чтобы вычислить максимальный размер массива, вызовите GetMaxByteCount метод . Метод GetByteCount обычно выделяет меньше памяти, в то время как GetMaxByteCount метод обычно выполняется быстрее.

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

Важно!

Чтобы обеспечить правильное декодирование закодированных байтов при их сохранении в виде файла или потока, можно префиксировать поток закодированных байтов с помощью префикса. Вставка заготовки в начале потока байтов (например, в начале ряда байтов, записываемых в файл) лежит на разработчике, а количество байтов в ней не отражается в значении, возвращаемом методом GetByteCount(String) .

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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetByteCount(Char*, Int32)

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Важно!

Этот API несовместим с CLS.

Вычисляет число байтов, полученных при кодировании набора символов начиная с заданного указателя символа.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);

[<System.CLSCompliant(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetByteCount : nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

Параметры

chars: Char*

Указатель на первый кодируемый символ.

count: Int32

Число кодируемых символов.

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

Int32

Число байтов, полученных при кодировании заданных символов.

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

-или-

ArgumentException

Включена функция обнаружения ошибок, chars содержит недопустимую последовательность символов.

EncoderFallbackException

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

- и -

Параметру EncoderFallback задается значение EncoderExceptionFallback.

Чтобы вычислить точный размер массива, который GetBytes требуется для хранения результирующего байта, вызовите GetByteCount метод . Чтобы вычислить максимальный размер массива, вызовите GetMaxByteCount метод . Метод GetByteCount обычно выделяет меньше памяти, в то время как GetMaxByteCount метод обычно выполняется быстрее.

Важно!

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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

GetByteCount(Char[], Int32, Int32)

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Вычисляет число байтов, полученных при кодировании набора символов из указанного массива символов.

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

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

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Параметры

chars: Char[]

Массив символов, содержащий набор кодируемых символов.

index: Int32

Индекс первого кодируемого символа.

count: Int32

Число кодируемых символов.

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

Int32

Число байтов, полученных при кодировании заданных символов.

Исключения

ArgumentNullException

chars имеет значение null (Nothing).

ArgumentOutOfRangeException

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

-или-

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

-или-

ArgumentException

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

EncoderFallbackException

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

- и -

Параметру EncoderFallback задается значение EncoderExceptionFallback.

Примеры

В следующем примере массив заполняется латинскими прописными и строчными буквами и вызывается GetByteCount(Char[], Int32, Int32) метод для определения количества байтов, необходимых для кодирования символов латинского нижнего регистра. Затем эта информация отображается вместе с общим количеством байтов, необходимым при добавлении метки порядка байтов. Он сравнивает это число со значением, возвращаемым методом GetMaxByteCount , которое указывает максимальное количество байтов, необходимое для кодирования символов нижнего регистра в латинском регистре. В следующем примере массив заполняется сочетанием греческих и кириллических символов и вызывается GetByteCount(Char[], Int32, Int32) метод для определения количества байтов, необходимых для кодирования кириллицы. Затем эта информация отображается вместе с общим количеством байтов, необходимым при добавлении метки порядка байтов. Это число сравнивается со значением, возвращаемым методом GetMaxByteCount , которое указывает максимальное количество байтов, необходимое для кодирования кириллических символов.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      int uppercaseStart = 0x0041;
      int uppercaseEnd = 0x005a;
      int lowercaseStart = 0x0061;
      int lowercaseEnd = 0x007a;
      // Instantiate a UTF8 encoding object with BOM support.
      Encoding unicode = Encoding.Unicode;

      // Populate array with characters.
      char[] chars = new char[lowercaseEnd - lowercaseStart + uppercaseEnd - uppercaseStart + 2];
      int index = 0;
      for (int ctr = uppercaseStart; ctr <= uppercaseEnd; ctr++) {
         chars[index] = (char)ctr;
         index++;
      }
      for (int ctr = lowercaseStart; ctr <= lowercaseEnd; ctr++) {
         chars[index] = (char)ctr;
         index++;
      }

      // Display the bytes needed for the lowercase characters.
      Console.WriteLine("Bytes needed for lowercase Latin characters:");
      Console.WriteLine("   Maximum:         {0,5:N0}",
                        unicode.GetMaxByteCount(lowercaseEnd - lowercaseStart + 1));
      Console.WriteLine("   Actual:          {0,5:N0}",
                        unicode.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                          lowercaseEnd - lowercaseStart + 1));
      Console.WriteLine("   Actual with BOM: {0,5:N0}",
                        unicode.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                          lowercaseEnd - lowercaseStart + 1) +
                                          unicode.GetPreamble().Length);
   }
}
// The example displays the following output:
//       Bytes needed for lowercase Latin characters:
//          Maximum:            54
//          Actual:             52
//          Actual with BOM:    54

Imports System.Text

Module Example
   Public Sub Main()
      Dim uppercaseStart As Integer = &h0041
      Dim uppercaseEnd As Integer = &h005a
      Dim lowercaseStart As Integer = &h0061
      Dim lowercaseEnd As Integer = &h007a
      ' Instantiate a UTF8 encoding object with BOM support.
      Dim unicode As Encoding = Encoding.Unicode
      
      ' Populate array with characters.
      Dim chars(lowercaseEnd - lowercaseStart + uppercaseEnd - uppercaseStart + 1) As Char
      Dim index As Integer = 0
      For ctr As Integer = uppercaseStart To uppercaseEnd
         chars(index) = ChrW(ctr)
         index += 1
      Next
      For ctr As Integer = lowercaseStart To lowercaseEnd
         chars(index) = ChrW(ctr)
         index += 1
      Next

      ' Display the bytes needed for the lowercase characters.
        Console.WriteLine("Bytes needed for lowercase Latin characters:")
        Console.WriteLine("   Maximum:         {0,5:N0}",
                          unicode.GetMaxByteCount(lowercaseEnd - lowercaseStart + 1))
        Console.WriteLine("   Actual:          {0,5:N0}",
                          unicode.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                            lowercaseEnd - lowercaseStart + 1))
        Console.WriteLine("   Actual with BOM: {0,5:N0}",
                          unicode.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                            lowercaseEnd - lowercaseStart + 1) +
                                            unicode.GetPreamble().Length)
   End Sub
End Module
' The example displays the following output:
'       Bytes needed for lowercase Latin characters:
'          Maximum:            54
'          Actual:             52
'          Actual with BOM:    54

Чтобы вычислить точный размер массива, необходимый GetBytes для хранения результирующего байта, приложение использует GetByteCount. Чтобы вычислить максимальный размер массива, вызовите GetMaxByteCount метод . Метод GetByteCount обычно выделяет меньше памяти, в то время как GetMaxByteCount метод обычно выполняется быстрее.

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

Чтобы обеспечить правильное декодирование закодированных байтов при их сохранении в виде файла или потока, можно префиксировать поток закодированных байтов с помощью префикса. Вставка заготовки в начале потока байтов (например, в начале ряда байтов, записываемых в файл) лежит на разработчике, а количество байтов в этой заемке не отражается в значении, возвращаемом методом GetByteCount(Char[], Int32, Int32) .

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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Будущее в ваших руках

Поделиться через

UnicodeEncoding.GetByteCount Метод

Определение

Перегрузки

GetByteCount(String)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к

GetByteCount(Char*, Int32)

Параметры

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

Исключения

Комментарии

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

Применяется к

GetByteCount(Char[], Int32, Int32)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к

Дополнительные ресурсы