ASCIIEncoding.GetMaxCharCount(Int32) Método

Definição

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

Calcula o número máximo de caracteres produzidos decodificação do número especificado de bytes.

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 pela decodificação do número especificado de bytes.

Exceções

ArgumentOutOfRangeException

byteCount é menor que zero.

-ou-

O número resultante de bytes é 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 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.

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

GetMaxCharCount não tem nenhuma relação com GetBytes. Se seu aplicativo precisar de uma função semelhante para usar GetBytes, ele deverá usar GetMaxByteCount.

Note

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

Aplica-se a

Confira também