ASCIIEncoding.GetMaxByteCount(Int32) Método

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

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.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar GetMaxByteCount el método para calcular los bytes necesarios para codificar un número especificado de caracteres.The following example demonstrates how to use the GetMaxByteCount method to calculate the bytes required to encode a specified number of characters.

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

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = 2;
        int maxByteCount = ascii.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}
Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = ascii.GetMaxByteCount(charCount)
        Console.WriteLine( _
            "Maximum of {0} bytes needed to encode {1} characters.", _
            maxByteCount, _
            charCount _
        )
    End Sub
End Class

Comentarios

El GetByteCount método calcula el tamaño exacto de la matriz que requiere GetBytes el método para almacenar los bytes resultantes, GetMaxByteCount mientras que el método calcula el tamaño máximo de la matriz.The GetByteCount method calculates the exact array size required by the GetBytes method to store the resulting bytes, whereas the GetMaxByteCount method calculates the maximum array size. El GetByteCount método generalmente asigna menos memoria, pero el GetMaxByteCount método suele ejecutarse más rápido.The GetByteCount method generally allocates less memory, but 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 elige una reserva de reemplazo con una cadena potencialmente grande, GetMaxByteCount puede devolver valores grandes.If you choose a replacement fallback with a potentially large string, GetMaxByteCount can return large values.

El GetMaxByteCount método considera posibles suplentes sobrantes de una operación de codificación anterior.The GetMaxByteCount method considers potential leftover surrogates from a previous encoding operation. Como resultado, si el ASCIIEncoding objeto usa la reserva de reemplazo predeterminada, o si se ha definido una reserva de reemplazo personalizada con un solo carácter de reserva posible, el método devuelve charCount + 1.As a result, if the ASCIIEncoding object uses the default replacement fallback, or if a custom replacement fallback has been defined with a single possible fallback character, the method returns charCount + 1. Si el ASCIIEncoding objeto utiliza una reserva de reemplazo con más de un posible carácter de reserva, el ** método devuelve ncharCount * (+ 1), donde n es el número máximo de caracteres de reserva.If the ASCIIEncoding object uses a replacement fallback with more than one possible fallback character, the method returns n * (charCount + 1), where n is the maximum number of fallback characters.

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: