ASCIIEncoding.GetMaxCharCount(Int32) Método

  • Referência

Definição

Namespace:
System.Text
Assemblies:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Calcula o número máximo de caracteres produzidos decodificando o número de bytes especificado.

public:
 override int GetMaxCharCount(int byteCount);
public override int GetMaxCharCount (int byteCount);
override this.GetMaxCharCount : int -> int
Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Parâmetros

byteCount
Int32

O número de bytes a serem decodificados.

Retornos

Int32

O número máximo de caracteres produzidos decodificando o número de bytes especificado.

Exceções

ArgumentOutOfRangeException

byteCount é menor que zero.

- ou - O número de bytes resultante é maior que o número máximo que pode ser retornado como um inteiro.

Exemplos

O exemplo a seguir demonstra como usar o GetMaxCharCount método para calcular o número máximo de caracteres necessários para decodificar um número especificado de bytes.

using namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = 8;
   int maxCharCount = ascii->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = 8;
        int maxCharCount = ascii.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = ascii.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub
End Class

Comentários

O GetCharCount método calcula o tamanho exato da matriz exigido pelo GetChars método para armazenar os caracteres resultantes, enquanto o GetMaxCharCount método calcula o tamanho máximo da matriz. O GetCharCount método geralmente aloca menos memória, enquanto o GetMaxCharCount método geralmente é executado mais rapidamente.

GetMaxCharCountRecupera um número pior, incluindo a pior hipótese para o selecionado no momento DecoderFallback . Se houver um fallback de decodificador que tenha um comprimento máximo de fallback de n, o GetMaxCharCount método retornará n * byteCount.

GetMaxCharCountNão tem relação com GetBytes . Se o aplicativo precisar de uma função semelhante para usar, GetBytesele deverá ser usado GetMaxByteCount.

Observação

GetMaxCharCount(N)Não é necessariamente o mesmo valor que N* GetMaxCharCount(1) .

Aplica-se a

Confira também