Encoding.GetMaxByteCount(Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, calcula el número máximo de bytes generados mediante la codificación del número especificado de caracteres.
public:
abstract int GetMaxByteCount(int charCount);public abstract int GetMaxByteCount(int charCount);abstract member GetMaxByteCount : int -> intPublic MustOverride Function GetMaxByteCount (charCount As Integer) As IntegerParámetros
- charCount
- Int32
Número de caracteres que se van a codificar.
Devoluciones
Número máximo de bytes producidos al codificar el número especificado de caracteres.
Excepciones
charCount es menor que cero.
Se produjo una reserva (para obtener más información, vea Codificación de caracteres en .NET).
- y -
El valor de EncoderFallback está establecido en EncoderExceptionFallback.
Ejemplos
En el ejemplo siguiente se determina el número de bytes necesarios para codificar una matriz de caracteres, codifica los caracteres y se muestran los bytes resultantes.
using System;
using System.Text;
public class SamplesEncoding {
public static void Main() {
// The characters to encode:
// Latin Small Letter Z (U+007A)
// Latin Small Letter A (U+0061)
// Combining Breve (U+0306)
// Latin Small Letter AE With Acute (U+01FD)
// Greek Small Letter Beta (U+03B2)
// a high-surrogate value (U+D8FF)
// a low-surrogate value (U+DCFF)
char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' };
// Get different encodings.
Encoding u7 = Encoding.UTF7;
Encoding u8 = Encoding.UTF8;
Encoding u16LE = Encoding.Unicode;
Encoding u16BE = Encoding.BigEndianUnicode;
Encoding u32 = Encoding.UTF32;
// Encode the entire array, and print out the counts and the resulting bytes.
PrintCountsAndBytes( myChars, u7 );
PrintCountsAndBytes( myChars, u8 );
PrintCountsAndBytes( myChars, u16LE );
PrintCountsAndBytes( myChars, u16BE );
PrintCountsAndBytes( myChars, u32 );
}
public static void PrintCountsAndBytes( char[] chars, Encoding enc ) {
// Display the name of the encoding used.
Console.Write( "{0,-30} :", enc.ToString() );
// Display the exact byte count.
int iBC = enc.GetByteCount( chars );
Console.Write( " {0,-3}", iBC );
// Display the maximum byte count.
int iMBC = enc.GetMaxByteCount( chars.Length );
Console.Write( " {0,-3} :", iMBC );
// Encode the array of chars.
byte[] bytes = enc.GetBytes( chars );
// Display all the encoded bytes.
PrintHexBytes( bytes );
}
public static void PrintHexBytes( byte[] bytes ) {
if (( bytes == null ) || ( bytes.Length == 0 ))
{
Console.WriteLine( "<none>" );
}
else {
for ( int i = 0; i < bytes.Length; i++ )
Console.Write( "{0:X2} ", bytes[i] );
Console.WriteLine();
}
}
}
/*
This code produces the following output.
System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00
*/
Imports System.Text
Public Class SamplesEncoding
Public Shared Sub Main()
' The characters to encode:
' Latin Small Letter Z (U+007A)
' Latin Small Letter A (U+0061)
' Combining Breve (U+0306)
' Latin Small Letter AE With Acute (U+01FD)
' Greek Small Letter Beta (U+03B2)
' a high-surrogate value (U+D8FF)
' a low-surrogate value (U+DCFF)
Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF)}
' Get different encodings.
Dim u7 As Encoding = Encoding.UTF7
Dim u8 As Encoding = Encoding.UTF8
Dim u16LE As Encoding = Encoding.Unicode
Dim u16BE As Encoding = Encoding.BigEndianUnicode
Dim u32 As Encoding = Encoding.UTF32
' Encode the entire array, and print out the counts and the resulting bytes.
PrintCountsAndBytes(myChars, u7)
PrintCountsAndBytes(myChars, u8)
PrintCountsAndBytes(myChars, u16LE)
PrintCountsAndBytes(myChars, u16BE)
PrintCountsAndBytes(myChars, u32)
End Sub
Public Shared Sub PrintCountsAndBytes(chars() As Char, enc As Encoding)
' Display the name of the encoding used.
Console.Write("{0,-30} :", enc.ToString())
' Display the exact byte count.
Dim iBC As Integer = enc.GetByteCount(chars)
Console.Write(" {0,-3}", iBC)
' Display the maximum byte count.
Dim iMBC As Integer = enc.GetMaxByteCount(chars.Length)
Console.Write(" {0,-3} :", iMBC)
' Encode the array of chars.
Dim bytes As Byte() = enc.GetBytes(chars)
' Display all the encoded bytes.
PrintHexBytes(bytes)
End Sub
Public Shared Sub PrintHexBytes(bytes() As Byte)
If bytes Is Nothing OrElse bytes.Length = 0 Then
Console.WriteLine("<none>")
Else
Dim i As Integer
For i = 0 To bytes.Length - 1
Console.Write("{0:X2} ", bytes(i))
Next i
Console.WriteLine()
End If
End Sub
End Class
'This code produces the following output.
'
'System.Text.UTF7Encoding : 18 23 :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
'System.Text.UTF8Encoding : 12 24 :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding : 14 16 :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding : 14 16 :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
'System.Text.UTF32Encoding : 24 32 :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00
Comentarios
El charCount parámetro especifica realmente el número de Char objetos que representan los caracteres Unicode que se van a codificar, ya que .NET usa internamente UTF-16 para representar caracteres Unicode. Por lo tanto, la mayoría de los caracteres Unicode se pueden representar mediante un Char objeto , pero un carácter Unicode representado por un par suplente, por ejemplo, requiere dos Char objetos.
Para calcular el tamaño exacto de la matriz requerido por GetBytes para almacenar los bytes resultantes, debe usar el GetByteCount método . Para calcular el tamaño máximo de la matriz, use el GetMaxByteCount método . El GetByteCount método generalmente permite la asignación de menos memoria, mientras que el GetMaxByteCount método generalmente se ejecuta más rápido.
GetMaxByteCount recupera 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, recupera valores grandes, GetMaxByteCount especialmente en los casos en los que el peor de los casos en que la codificación implica cambiar modos para cada carácter. Por ejemplo, esto puede ocurrir para ISO-2022-JP. Para obtener más información, consulte la entrada de blog "What's with Encoding.GetMaxByteCount() and Encoding.GetMaxCharCount()?.
En la mayoría de los casos, este método recupera valores 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 cuando un búfer más razonable es demasiado pequeño. También puede considerar un enfoque diferente mediante GetByteCount o Encoder.Convert.
Al usar GetMaxByteCount, debe asignar el búfer de salida en función del tamaño máximo del búfer de entrada. Si el búfer de salida está restringido en tamaño, puede usar el Convert método .
Tenga en cuenta que GetMaxByteCount considera posibles suplentes sobrantes de una operación anterior del descodificador. Debido al descodificador, pasar un valor de 1 al método recupera 2 para una codificación de un solo byte, como ASCII. Debe usar la IsSingleByte propiedad si esta información es necesaria.
Nota:
GetMaxByteCount(N) no es necesariamente el mismo valor que N* GetMaxByteCount(1).
Notas a los implementadores
Todas las Encoding implementaciones deben garantizar que no se produzcan excepciones de desbordamiento de búfer si los búferes tienen un tamaño según los resultados de los cálculos de este método.
