UnicodeEncoding.GetMaxCharCount(Int32) Método
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í.
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
- byteCount
- Int32
Número de bytes que se van a descodificar.
Número máximo de caracteres que se generan al descodificar el número de bytes especificado.
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.
Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)
- y -
El valor de DecoderFallback está establecido en DecoderExceptionFallback.
En el ejemplo siguiente se muestra cómo usar el GetMaxCharCount método para devolver el número máximo de caracteres generados mediante la descodificación de un número especificado de bytes.
using namespace System;
using namespace System::Text;
int main()
{
UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
int byteCount = 8;
int maxCharCount = Unicode->GetMaxCharCount( byteCount );
Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}
using System;
using System.Text;
class UnicodeEncodingExample {
public static void Main() {
UnicodeEncoding Unicode = new UnicodeEncoding();
int byteCount = 8;
int maxCharCount = Unicode.GetMaxCharCount(byteCount);
Console.WriteLine(
"Maximum of {0} characters needed to decode {1} bytes.",
maxCharCount,
byteCount
);
}
}
Imports System.Text
Class UnicodeEncodingExample
Public Shared Sub Main()
Dim uni As New UnicodeEncoding()
Dim byteCount As Integer = 8
Dim maxCharCount As Integer = uni.GetMaxCharCount(byteCount)
Console.WriteLine("Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount)
End Sub
End Class
Para calcular el tamaño exacto de la matriz requerido por GetChars para almacenar los caracteres resultantes, la aplicación usa GetCharCount. Para calcular el tamaño máximo de la matriz, la aplicación debe usar GetMaxCharCount. El GetCharCount método suele asignar menos memoria, mientras que el GetMaxCharCount método normalmente 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 se elige una reserva con una cadena potencialmente grande, GetMaxCharCount recupera valores grandes.
En la mayoría de los casos, este método recupera 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 GetCharCount o 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)
.
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: