UTF7Encoding.GetCharCount Метод

Определение

Пространство имен:
System.Text
Сборки:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Сборки:
netstandard.dll, System.Text.Encoding.Extensions.dll
Сборка:
System.Text.Encoding.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
GetCharCount(Byte[], Int32, Int32)

Вычисляет количество символов, созданных путем декодирования последовательности байтов из указанного массива байтов.
GetCharCount(Byte*, Int32)

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

GetCharCount(Byte[], Int32, Int32)

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

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

public:
 override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);
public override int GetCharCount(byte[] bytes, int index, int count);
override this.GetCharCount : byte[] * int * int -> int
Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Параметры

bytes
Byte[]

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

index
Int32

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

count
Int32

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

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

Int32

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

Исключения

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

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

–или–

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

–или–

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

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

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();
        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, используйте GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. Этот GetCharCount метод обычно позволяет выделять меньше памяти, а GetMaxCharCount метод обычно выполняется быстрее.

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

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

GetCharCount(Byte*, Int32)

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

Внимание

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

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

public:
 override int GetCharCount(System::Byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

Параметры

bytes
Byte*

Указатель на первый байт для декодации.

count
Int32

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

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

Int32

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

Атрибуты
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Исключения

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

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

–или–

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, используйте GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. Этот GetCharCount метод обычно позволяет выделять меньше памяти, а GetMaxCharCount метод обычно выполняется быстрее.

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

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