ASCIIEncoding.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 calcular los bytes necesarios para codificar un número especificado de caracteres.

using System;
using System.Text;

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

Imports System.Text

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

Comentarios

El GetByteCount método calcula el tamaño exacto de la matriz requerido por el GetBytes método para almacenar los bytes resultantes, mientras que el GetMaxByteCount método calcula el tamaño máximo de la matriz. El GetByteCount método normalmente asigna menos memoria, pero el GetMaxByteCount método normalmente se ejecuta más rápido.

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

El GetMaxByteCount método considera posibles suplentes sobrantes de una operación de codificación anterior. Como resultado, si el ASCIIEncoding objeto usa la reserva de reemplazo predeterminada o si se ha definido una reserva de reemplazo personalizada con un único carácter de reserva posible, el método devuelve charCount + 1. Si el ASCIIEncoding objeto usa una reserva de reemplazo con más de un carácter de reserva posible, el método devuelve n * (charCount + 1), donde n es el número máximo de caracteres de reserva.

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()