UTF7Encoding.GetMaxCharCount(Int32) Método

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

Devoluções

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

Exceções

Exemplos

O exemplo de código seguinte demonstra como usar o GetMaxCharCount método para devolver o número máximo de caracteres produzidos ao decodificar um determinado número de bytes.

using System;
using System.Text;

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

Imports System.Text

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

Observações

Para calcular o tamanho exato do array necessário GetChars para armazenar os caracteres resultantes, a aplicação utiliza GetCharCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxCharCount. O GetCharCount método geralmente permite a alocação de menos memória, enquanto o GetMaxCharCount método geralmente é executado mais rapidamente.

GetMaxCharCount é um número do pior caso, incluindo o pior caso para o atualmente selecionado DecoderFallback. Se for escolhido um plano B com uma cadeia potencialmente grande, GetMaxCharCount pode devolver valores elevados.

Na maioria dos casos, este método devolve números razoáveis para cadeias pequenas. Para cadeias grandes, pode ter de escolher entre usar buffers muito grandes e apanhar erros no raro caso de ultrapassar um buffer mais razoável. Também pode querer considerar uma abordagem diferente usando GetCharCount ou Decoder.Convert.

GetMaxCharCount não tem relação com GetBytes. Se a sua aplicação precisar de uma função semelhante para usar , GetBytesdeverá usar GetMaxByteCount.

Ver também

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetString(Byte[], Int32, Int32)
• GetCharCount(Byte[], Int32, Int32)
• GetDecoder()