UTF8Encoding.GetMaxByteCount(Int32) Método

Definición

Calcula el número máximo de bytes generado mediante la codificación del número de caracteres especificado.Calculates the maximum number of bytes produced by encoding the specified number of characters.

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.The number of characters to encode.

Devoluciones

Número máximo de bytes generados al codificar el número de caracteres especificado.The maximum number of bytes produced by encoding the specified number of characters.

Excepciones

charCount es menor que cero.charCount is less than zero.

O bien,-or- El número de bytes resultante es mayor que el número máximo que se puede devolver como entero.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)A fallback occurred (for more information, see Character Encoding in .NET) y-and- El valor deEncoderFallback está establecido en EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se usa el método GetMaxByteCount para devolver el número máximo de bytes necesarios para codificar un número especificado de caracteres.The following example uses the GetMaxByteCount method to return the maximum number of bytes required to encode a specified number of characters.

using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int charCount = 2;
   int maxByteCount = utf8->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int charCount = 2;
        int maxByteCount = utf8.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf8.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, se llama al método GetByteCount.To calculate the exact array size required by GetBytes to store the resulting bytes, you call the GetByteCount method. Para calcular el tamaño máximo de la matriz, llame al método GetMaxByteCount.To calculate the maximum array size, you call the GetMaxByteCount method. El método GetByteCount generalmente asigna menos memoria, mientras que el método GetMaxByteCount generalmente se ejecuta más rápido.The GetByteCount method generally allocates less memory, while the GetMaxByteCount method generally executes faster.

GetMaxByteCount es un número en el peor de los casos, incluido el peor caso del EncoderFallbackseleccionado actualmente.GetMaxByteCount is a worst-case number, including the worst case for the currently selected EncoderFallback. Si se elige una reserva con una cadena potencialmente grande, GetMaxByteCount puede devolver valores grandes.If a fallback is chosen with a potentially large string, GetMaxByteCount can return large values.

En la mayoría de los casos, este método devuelve números razonables para cadenas pequeñas.In most cases, this method returns reasonable numbers for small strings. En el caso de las cadenas de gran tamaño, es posible que tenga que elegir entre usar búferes de gran tamaño y detectar errores en el caso excepcional de que se supere un búfer más razonable.For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. Es posible que también desee considerar un enfoque diferente con GetByteCount o Encoder.Convert.You might also want to consider a different approach using GetByteCount or Encoder.Convert. Por ejemplo, el texto en inglés y muchos otros idiomas suelen necesitar un solo byte UTF-8 para representar un carácter, pero el número devuelto por GetMaxByteCount tiene que permitir la posibilidad de que la cadena que se va a convertir consista únicamente en caracteres, cada uno de los cuales requiere cuatro bytes.For example, text in English and many other languages often needs only one UTF-8 byte to represent a character, but the number returned by GetMaxByteCount has to allow for the possibility that the string to be converted will consist entirely of characters that each require four bytes.

GetMaxByteCount no tiene ninguna relación con GetChars.GetMaxByteCount has no relation to GetChars. Si la aplicación necesita una función similar para usar con GetChars, debe usar GetMaxCharCount.If your application needs a similar function to use with GetChars, it should use GetMaxCharCount.

Nota

GetMaxByteCount(N) no es necesariamente el mismo valor que N* GetMaxByteCount(1).GetMaxByteCount(N) is not necessarily the same value as N* GetMaxByteCount(1).

Se aplica a

Consulte también: