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 GetMaxByteCount usa el 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 la matriz GetBytes que requiere para almacenar los bytes resultantes, GetByteCount se llama al 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 GetMaxByteCount al método.To calculate the maximum array size, you call the GetMaxByteCount method. El GetByteCount método generalmente asigna menos memoria, mientras que el GetMaxByteCount método se ejecuta normalmente más rápido.The GetByteCount method generally allocates less memory, while the GetMaxByteCount method generally executes faster.

GetMaxByteCountes un número en el peor de los casos, incluido el peor de los EncoderFallbackcasos del seleccionado 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. También podría querer considerar un enfoque diferente mediante GetByteCount o. Encoder.ConvertYou might also want to consider a different approach using GetByteCount or Encoder.Convert. Por ejemplo, el texto en inglés y muchos otros lenguajes suelen necesitar un solo byte UTF-8 para representar un carácter, pero el número GetMaxByteCount devuelto por tiene que permitir la posibilidad de que la cadena que se va a convertir consista únicamente en 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.

GetMaxByteCountno tiene ninguna relación GetCharscon.GetMaxByteCount has no relation to GetChars. Si la aplicación necesita una función similar para usar con GetChars, debe usar. GetMaxCharCountIf 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: