ASCIIEncoding.GetCharCount Метод

Определение

Вычисляет количество символов, полученных при декодировании последовательности байтов.Calculates the number of characters produced by decoding a sequence of bytes.

Перегрузки

GetCharCount(Byte[], Int32, Int32)

Вычисляет количество символов, полученных при декодировании последовательности байтов из заданного массива байтов.Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(Byte*, Int32)

Вычисляет количество символов, полученных при декодировании последовательности байтов начиная с заданного указателя байта.Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

GetCharCount(ReadOnlySpan<Byte>)

Вычисляет количество символов, полученных при декодировании заданного диапазона байтов.Calculates the number of characters produced by decoding the specified byte span.

GetCharCount(Byte[], Int32, Int32)

Вычисляет количество символов, полученных при декодировании последовательности байтов из заданного массива байтов.Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

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[]

Массив байтов, содержащий последовательность байтов, которую требуется декодировать.The byte array containing the sequence of bytes to decode.

index
Int32

Индекс первого декодируемого байта.The index of the first byte to decode.

count
Int32

Число байтов для декодирования.The number of bytes to decode.

Возвраты

Число символов, полученных при декодировании заданной последовательности байтов.The number of characters produced by decoding the specified sequence of bytes.

Исключения

Свойство bytes имеет значение null.bytes is null.

Значение параметра index или count меньше нуля.index or count is less than zero.

- или --or- Параметрыindex и count не указывают допустимый диапазон в bytes.index and count do not denote a valid range in bytes.

- или --or- Результирующее число байтов больше максимального количества, которое можно вернуть как целочисленное значение.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Произошел откат (см. сведения о кодировке символов в .NET)A fallback occurred (for more information, see Character Encoding in .NET) - и --and- Параметру DecoderFallback задается значение DecoderExceptionFallback.DecoderFallback is set to DecoderExceptionFallback.

Примеры

В следующем примере показано, как использовать метод GetCharCount для получения количества символов, полученных при декодировании диапазона элементов в массиве байтов.The following example demonstrates how to use the GetCharCount method to return the number of characters produced by decoding a range of elements in a byte array.

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = ascii.GetCharCount(bytes, 6, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}
Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}
      
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, приложение использует GetCharCount.To calculate the exact array size required by GetChars to store the resulting characters, the application uses GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount.To calculate the maximum array size, the application should use GetMaxCharCount. Метод GetCharCount обычно позволяет выделить меньше памяти, а метод GetMaxCharCount обычно выполняется быстрее.The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.

Дополнительно

GetCharCount(Byte*, Int32)

Важно!

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

Альтернативный вариант, совместимый с CLS
System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Вычисляет количество символов, полученных при декодировании последовательности байтов начиная с заданного указателя байта.Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

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

Параметры

bytes
Byte*

Указатель на первый декодируемый байт.A pointer to the first byte to decode.

count
Int32

Число байтов для декодирования.The number of bytes to decode.

Возвраты

Число символов, полученных при декодировании заданной последовательности байтов.The number of characters produced by decoding the specified sequence of bytes.

Атрибуты

Исключения

bytesnull.bytes is null.

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

- или --or- Результирующее число байтов больше максимального количества, которое можно вернуть как целочисленное значение.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Произошел откат (см. сведения о кодировке символов в .NET)A fallback occurred (for more information, see Character Encoding in .NET) - и --and- Параметру DecoderFallback задается значение DecoderExceptionFallback.DecoderFallback is set to DecoderExceptionFallback.

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, приложение использует GetCharCount.To calculate the exact array size required by GetChars to store the resulting characters, the application uses GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount.To calculate the maximum array size, the application should use GetMaxCharCount. Метод GetCharCount обычно позволяет выделить меньше памяти, а метод GetMaxCharCount обычно выполняется быстрее.The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.

Безопасность

SecurityCriticalAttribute
Требуется полное доверие для немедленного вызывающего объекта.Requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

GetCharCount(ReadOnlySpan<Byte>)

Вычисляет количество символов, полученных при декодировании заданного диапазона байтов.Calculates the number of characters produced by decoding the specified byte span.

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);
public override int GetCharCount (ReadOnlySpan<byte> bytes);
override this.GetCharCount : ReadOnlySpan<byte> -> int
Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Параметры

bytes
ReadOnlySpan<Byte>

Диапазон, содержащий набор байтов для декодирования.The span containing the set of bytes to decode.

Возвраты

Количество символов, полученных при декодировании заданного диапазона байтов.The number of characters produced by decoding the specified byte span.

Комментарии

Чтобы вычислить точный размер, требуемый GetChars для хранения полученных символов, используйте GetCharCount.To calculate the exact size required by GetChars to store the resulting characters, use GetCharCount. Чтобы вычислить максимальный размер, используйте GetMaxCharCount.To calculate the maximum size, use GetMaxCharCount. Метод GetCharCount обычно позволяет выделить меньше памяти, а метод GetMaxCharCount обычно выполняется быстрее.The GetCharCount method generally allows allocation of less memory, while the GetMaxCharCount method generally executes faster.

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