UTF8Encoding.GetMaxCharCount(Int32) UTF8Encoding.GetMaxCharCount(Int32) UTF8Encoding.GetMaxCharCount(Int32) UTF8Encoding.GetMaxCharCount(Int32) Method

Definición

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

public:
 override int GetMaxCharCount(int byteCount);
public override int GetMaxCharCount (int byteCount);
override this.GetMaxCharCount : int -> int
Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Parámetros

byteCount
Int32 Int32 Int32 Int32

Número de bytes que se van a descodificar.The number of bytes to decode.

Devoluciones

Número máximo de caracteres que se generan al descodificar el número de bytes especificado.The maximum number of characters produced by decoding the specified number of bytes.

Excepciones

byteCount es menor que cero.byteCount 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 DecoderFallback está establecido en DecoderExceptionFallback.DecoderFallback is set to DecoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se GetMaxCharCount usa el método para devolver el número máximo de caracteres que se generan al descodificar un número especificado de bytes.The following example uses the GetMaxCharCount method to return the maximum number of characters produced by decoding a specified number of bytes.

using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = 8;
   int maxCharCount = utf8->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int byteCount = 8;
        int maxCharCount = utf8.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}
Imports System
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = utf8.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub 'Main
End Class 'UTF8EncodingExample

Comentarios

Para calcular el tamaño exacto de la matriz GetChars necesario para almacenar los caracteres resultantes, se GetCharCount llama al método.To calculate the exact array size required by GetChars to store the resulting characters, you call the GetCharCount method. Para calcular el tamaño máximo de la matriz, llame GetMaxCharCount al método.To calculate the maximum array size, you call the GetMaxCharCount method. El GetCharCount método generalmente asigna menos memoria, mientras que el GetMaxCharCount método se ejecuta normalmente más rápido.The GetCharCount method generally allocates less memory, while the GetMaxCharCount method generally executes faster.

GetMaxCharCountes un número en el peor de los casos, incluido el peor de los DecoderFallbackcasos del seleccionado actualmente.GetMaxCharCount is a worst-case number, including the worst case for the currently selected DecoderFallback. Si se elige una reserva con una cadena potencialmente grande, GetMaxCharCount puede devolver valores grandes.If a fallback is chosen with a potentially large string, GetMaxCharCount 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 GetCharCount o. Encoder.ConvertYou might also want to consider a different approach using GetCharCount or Encoder.Convert.

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

Nota

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

Se aplica a

Consulte también: