UnicodeEncoding.GetMaxByteCount(Int32) Método

public:
 override int GetMaxByteCount(int charCount);

public override int GetMaxByteCount(int charCount);

override this.GetMaxByteCount : int -> int

Public Overrides Function GetMaxByteCount (charCount As Integer) As Integer

Parámetros

Devoluciones

Número máximo de bytes producidos al codificar el número especificado de caracteres.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo usar el GetMaxByteCount método para devolver el número máximo de bytes necesarios para codificar un número especificado de caracteres.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding Unicode = new UnicodeEncoding();
        int charCount = 2;
        int maxByteCount = Unicode.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = uni.GetMaxByteCount(charCount)
        Console.WriteLine("Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount)
    End Sub
End Class

Comentarios

Para calcular el tamaño exacto de la matriz requerido por GetBytes para almacenar los bytes resultantes, la aplicación usa GetByteCount. Para calcular el tamaño máximo de la matriz, la aplicación debe usar GetMaxByteCount. El GetByteCount método normalmente asigna menos memoria, mientras que el GetMaxByteCount método generalmente se ejecuta más rápido.

GetMaxByteCount recupera un número de peor caso, incluido el peor de los casos para el seleccionado EncoderFallbackactualmente. Si se elige una reserva con una cadena potencialmente grande, GetMaxByteCount puede devolver valores grandes.

En la mayoría de los casos, este método recupera números razonables para cadenas pequeñas. En el caso de las cadenas grandes, es posible que tenga que elegir entre usar búferes muy grandes y detectar errores en el caso poco frecuente de que se supere un búfer más razonable. También puede considerar un enfoque diferente mediante GetByteCount o Encoder.Convert.

GetMaxByteCount no tiene ninguna relación con GetChars. Si la aplicación necesita una función similar para usarla con GetChars, debe usar GetMaxCharCount.

Consulte también

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetEncoder()