Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

NumberFormatInfo — reglas de formato numérico

NumberFormatInfo proporciona reglas para dar formato y analizar números, incluidos los separadores y los símbolos de moneda. Aprende sus métodos principales, la diferencia entre la configuración actual y la invariable, y cómo crear de forma segura una configuración personalizada.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);

NumberFormatInfo de System.Globalization es un IFormatProvider para dar formato y analizar números. Pásalo a métodos como decimal.ToString y decimal.Parse; no expone por sí mismo un método Parse ni un método numérico ToString. NumberDecimalSeparator y NumberGroupSeparator controlan el formato numérico; las monedas y los porcentajes tienen propiedades independientes.

Los métodos principales de NumberFormatInfo que se presentan en el curso son GetInstance, GetFormat, Clone y ReadOnly. GetInstance(provider) obtiene la configuración del proveedor y recurre a la cultura actual si no puede obtenerla. No garantiza una copia editable. GetFormat(typeof(NumberFormatInfo)) devuelve el objeto actual; para otro tipo devuelve null.

Clone() devuelve una copia modificable como object, por lo que se necesita una conversión de tipo. ReadOnly(nfi) devuelve un objeto de solo lectura: usa la referencia devuelta. IsReadOnly indica este estado; intentar cambiar una propiedad de ese objeto produce InvalidOperationException. ReadOnly(null) produce ArgumentNullException.

CurrentInfo depende de la cultura actual. Si asignas un clon modificable de una cultura a CultureInfo.CurrentCulture, CurrentInfo puede devolver el objeto NumberFormatInfo modificable de ese clon. InvariantInfo proporciona reglas independientes de la cultura y es de solo lectura. El ejemplo clona InvariantInfo, establece los separadores y usa "N2" para agrupar con dos decimales. El análisis utiliza las mismas reglas junto con NumberStyles.Number. El código está dirigido a net10.0 y no requiere características del lenguaje en vista previa.

Ejemplos

using System;
using System.Globalization;

NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
nfi.NumberDecimalSeparator = ",";
nfi.NumberGroupSeparator = "_";
nfi.NumberGroupSizes = new[] { 3 };

NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);
string text = 12345.67m.ToString("N2", frozen);
Console.WriteLine(text);

decimal parsed = decimal.Parse(text, NumberStyles.Number, frozen);
Console.WriteLine(parsed.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(frozen.IsReadOnly);

Resultado

12_345,67
12345.67
True

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes