UTF7Encoding.GetMaxByteCount(Int32) Método

  • Referencia

Definición

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

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

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.

Devoluciones

Int32

Número máximo de bytes generados al codificar el número de caracteres especificado.

Excepciones

ArgumentOutOfRangeException

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

EncoderFallbackException

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el GetMaxByteCount método para devolver el número máximo de bytes necesarios para codificar un número especificado de caracteres.

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

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        int charCount = 2;
        int maxByteCount = utf7.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf7.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, la aplicación usa GetByteCount. Para calcular el tamaño máximo de la matriz, la aplicación debe usar GetMaxByteCount. El GetByteCount método generalmente permite la asignación de menos memoria, mientras que el GetMaxByteCount método suele ejecutarse más rápido.

GetMaxByteCount es un número de peor caso, incluido el peor de los casos para el seleccionado EncoderFallbackactualmente. Si se elige una reserva con una cadena potencialmente grande, GetMaxByteCount 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 raro de que se supere un búfer más razonable. También podría querer considerar un enfoque diferente mediante GetByteCount o Encoder.Convert . Aunque UTF-7 es muy eficaz en la codificación de datos ASCII, un byte por carácter, es extremadamente ineficaz para otros datos. Como se ha comentado anteriormente, GetMaxByteCount trata con un peor caso. Si los datos que se van a codificar son en gran medida ASCII y, especialmente, si el clúster de caracteres ASCII juntos, UTF-7 es significativamente más eficaz que el número devuelto por este método sugiere.

GetMaxByteCountno tiene ninguna relación con GetChars . Si la aplicación necesita una función similar para usarla con GetChars, debe usar GetMaxCharCount.

Nota

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

Se aplica a

Consulte también