UTF8Encoding.GetMaxCharCount(Int32) Método

  • Referencia

Definición

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

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

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

Número de bytes que se van a descodificar.

Devoluciones

Int32

Número máximo de caracteres que se generan al descodificar el número de bytes especificado.

Excepciones

ArgumentOutOfRangeException

byteCount 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.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

Ejemplos

En el ejemplo siguiente se usa el GetMaxCharCount método para devolver el número máximo de caracteres producidos mediante la descodificación de un número especificado de 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.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
End Class

Comentarios

Para calcular el tamaño exacto de la matriz requerido por GetChars para almacenar los caracteres resultantes, llame al GetCharCount método . Para calcular el tamaño máximo de la matriz, llame al GetMaxCharCount método . Por lo general, el GetCharCount método asigna menos memoria, mientras que el GetMaxCharCount método generalmente se ejecuta más rápido.

GetMaxCharCount es un número de peor caso, incluido el peor de los casos para el seleccionado DecoderFallbackactualmente. Si se elige una reserva con una cadena potencialmente grande, GetMaxCharCount puede devolver valores grandes.

En la mayoría de los casos, este método devuelve números razonables para cadenas pequeñas. En el caso de las cadenas grandes, es posible que tenga que elegir entre usar búferes muy grandes y detectar errores en el caso poco frecuente de que se supere un búfer más razonable. También podría querer considerar un enfoque diferente mediante GetCharCount o Encoder.Convert .

GetMaxCharCountno tiene ninguna relación con GetBytes . Si la aplicación necesita una función similar para usarla con GetBytes, debe usar GetMaxByteCount.

Nota

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

Se aplica a

Consulte también