UTF7Encoding.GetCharCount Метод

Ссылка

Определение

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

Сборки:: mscorlib.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

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

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 имеет значение null (Nothing).

ArgumentOutOfRangeException

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

-или-

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

-или-

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

DecoderFallbackException

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

- и -

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

Примеры

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

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = Unicode->GetCharCount( bytes, 2, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

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 как метод обычно выполняется быстрее.

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

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

.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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetCharCount(Byte*, Int32)

Исходный код:: 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 имеет значение null (Nothing).

ArgumentOutOfRangeException

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

-или-

DecoderFallbackException

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

- и -

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

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

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

.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	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.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

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

Открыть проблему с документацией Отзыв о продукте

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

Определение

Перегрузки

GetCharCount(Byte[], Int32, Int32)

Параметры

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

Исключения

Примеры

Комментарии

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

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

GetCharCount(Byte*, Int32)

Параметры

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

Исключения

Комментарии

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

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