ASCIIEncoding.GetMaxCharCount(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 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.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el GetMaxCharCount método para calcular el número máximo de caracteres necesarios para descodificar un número especificado de bytes.

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

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = 8;
        int maxCharCount = ascii.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

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

Comentarios

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

GetMaxCharCountRecupera un número en el peor de los casos, incluido el peor de los casos del seleccionado actualmente DecoderFallback . Si hay una reserva de descodificador que tiene una longitud de reserva máxima de n, el GetMaxCharCount método devuelve n * byteCount.

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