ASCIIEncoding.GetMaxByteCount(Int32) Método

  • Referencia

Definición

Espacio de nombres:
System.Text
Ensamblados:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Ensamblado:
System.Text.Encoding.Extensions.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Calcula el número máximo de bytes generado mediante la codificación del número de caracteres especificado.

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

charCount
Int32

Número de caracteres que se van a codificar.

Devoluciones

Int32

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

Excepciones

ArgumentOutOfRangeException

charCount es menor que cero.

O bien El número de bytes resultante es mayor que el número máximo que se puede devolver como entero.

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 namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = 2;
   int maxByteCount = ascii->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

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. Por lo general, el GetByteCount método asigna menos memoria, pero el GetMaxByteCount método generalmente 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.

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

Nota

GetMaxByteCount(N)no es necesariamente el mismo valor que N* GetMaxByteCount(1) .

Se aplica a

Consulte también