UTF8Encoding.GetMaxByteCount(Int32) UTF8Encoding.GetMaxByteCount(Int32) UTF8Encoding.GetMaxByteCount(Int32) UTF8Encoding.GetMaxByteCount(Int32) Method

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 Int32 Int32 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 acción de reserva (vea Codificación de caracteres en .NET Framework para obtener una explicación completa).A fallback occurred (see Character Encoding in the .NET Framework for complete explanation) - y --and- El valor de EncoderFallback está establecido en EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se usa el GetMaxByteCount método 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
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 'Main
End Class 'UTF8EncodingExample

Comentarios

Para calcular el tamaño exacto de matriz requerido GetBytes para almacenar los bytes resultantes, llame a la GetByteCount método.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 a la GetMaxByteCount método.To calculate the maximum array size, you call the GetMaxByteCount method. El GetByteCount método asigna generalmente menos memoria, mientras que el GetMaxByteCount método generalmente se ejecuta con mayor rapidez.The GetByteCount method generally allocates less memory, while the GetMaxByteCount method generally executes faster.

GetMaxByteCount es un número peor, incluido el peor de los casos para el que se han seleccionado actualmente EncoderFallback.GetMaxByteCount is a worst-case number, including the worst case for the currently selected EncoderFallback. Si se elige una acción de 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 un número razonable de las cadenas pequeñas.In most cases, this method returns reasonable numbers for small strings. Cadenas de gran tamaño, tendrá que elegir entre usar búferes muy grandes y detectar errores en el caso excepcional de que se ha superado 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. También puede tener en cuenta un enfoque diferente utilizando GetByteCount o Encoder.Convert.You might also want to consider a different approach using GetByteCount or Encoder.Convert. Por ejemplo, texto en inglés y muchos otros lenguajes a menudo necesita un solo byte de 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 conste únicamente de caracteres que cada uno 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 a 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: