Cómo establecer formatos de datos de celda en C# con IronXL
IronXL permite formatear celdas de Excel con formatos de datos incorporados como moneda, porcentajes, fechas y formatos de números personalizados estableciendo la propiedad FormatString en celdas o rangos sin dependencias de Interop.
Este ejemplo muestra cómo crear un nuevo libro de Excel y aplicar un formato incorporado a una celda específica utilizando la API de IronXL. No se necesitan dependencias de Interop, solo establezca FormatString y guarde.
-
1Install IronXL with NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
IronXL.WorkBook book = IronXL.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;C# -
3Despliegue para probar en su entorno real
Comienza a usar IronXL en tu proyecto hoy mismo con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca C# para configurar el formato de datos
- Abrir una hoja de cálculo de Excel existente o crear una nueva
- Establezca la propiedad FormatString de la celda, columna, fila o rango en el formato de datos deseado
- Utilice el formato de datos incorporado con la clase BuiltinFormats
- Exporte la hoja de cálculo editada en varios tipos de archivos
¿Cómo establecer formatos de datos de celda en Excel?
La propiedad FormatString se puede acceder tanto a través de celdas como de rangos. Por lo tanto, es posible establecer formatos de datos para celdas individuales, columnas, filas y cualquier rango seleccionado. Esta flexibilidad hace que IronXL sea especialmente potente cuando se necesita trabajar con archivos Excel en C# sin Interop.
El formato de los datos es esencial para presentar la información con claridad en las hojas de cálculo. Ya se trate de crear informes financieros con valores monetarios, datos científicos con decimales precisos o análisis basados en fechas, un formato adecuado garantiza que los datos sean legibles y profesionales. IronXL simplifica este proceso proporcionando acceso directo al motor de formato de Excel a través de una API sencilla.
using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;
// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";
// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);
IronXL.Range range = workSheet["A3:A5"];
// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";
workBook.SaveAs("dataFormats.xlsx");Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq
' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Set the data format to 12300.00%
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2
' Set the data format to 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"
' Set data display format to range
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)
Private range As IronXL.Range = workSheet("A3:A5")
' Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss"
workBook.SaveAs("dataFormats.xlsx")
¿Cómo puedo establecer valores de celda como cadenas sin conversión?
Al establecer el valor en IronXL, use StringValue en lugar de Value para asignar directamente el valor exacto a la celda sin conversión automática. Esto funciona como colocar un apóstrofo antes del valor de la celda en Excel. Esta técnica es especialmente útil cuando se trabaja con códigos de producto, números de teléfono u otros datos que deben permanecer como texto. Para una manipulación de cadenas más avanzada, consulte cómo escribir valores de Excel en .NET.
// Assign value as string
workSheet["A1"].StringValue = "4402-12";' Assign value as string
workSheet("A1").StringValue = "4402-12"¿Cómo uso los formatos incorporados en IronXL?
La biblioteca IronXL ofrece una variedad de cadenas de formato predefinidas que se pueden acceder a través de la clase IronXL.Formatting.BuiltinFormats para formatear celdas de Excel. Esto te permite personalizar cómo se muestran los datos en tus hojas de cálculo de Excel. Estos formatos incorporados cubren los escenarios empresariales más comunes y son compatibles con todas las versiones de Excel.
Cuando creas hojas de cálculo mediante programación, aplicar un formato coherente es crucial para mantener los estándares profesionales en todos tus documentos. La clase BuiltinFormats proporciona más de 30 patrones de formato preconfigurados que coinciden con las opciones de formato estándar de Excel.
using IronXL;
using IronXL.Formatting;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;
workBook.SaveAs("builtinDataFormats.xlsx");Imports IronXL
Imports IronXL.Formatting
' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Use builtin formats
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0
workBook.SaveAs("builtinDataFormats.xlsx")¿Qué formatos de datos integrados hay disponibles?
Para el tipo Duration, los valores de entrada se representan en días. Por ejemplo, 1 día equivale a 24 horas, y 1,05 días a 25 horas y 12 minutos. Esto resulta especialmente útil cuando se trabaja con datos de Excel que implican el seguimiento del tiempo o la gestión de proyectos. Aquí están los tipos de formato disponibles:
¿Qué hace cada tipo de formato?
General: Formato predeterminado que muestra números sin un formato específico.Duration1: Muestra la duración en minutos y segundos como 'mm:ss'.Duration2: Muestra la duración en horas, minutos y segundos como '[h]:mm:ss'.Duration3: Muestra la duración en minutos, segundos y milisegundos como 'mm:ss.0'.Accounting0: Formato de contabilidad sin decimales, con paréntesis para negativos como '#,##0_);(#,##0).'Accounting0Red: Formato de contabilidad sin decimales, rojo para negativos como '#,##0_);Red.'Accounting2: Formato de contabilidad con dos decimales, con paréntesis para negativos como '#,##0.00;(#,##0.00).'Accounting2Red: Formato de contabilidad con dos decimales, rojo para negativos como '#,##0.00_);Red.'Time1: Formato de 12 horas con AM/PM como 'h:mm AM/PM'.Time2: Formato de 12 horas con segundos y AM/PM como 'h:mm:ss AM/PM'.Time3: Formato de 24 horas sin segundos como 'h:mm'.Time4: Formato de 24 horas con segundos como 'h:mm:ss'.ShortDate: Formato de fecha corta como 'm/d/yy'.ShortDateAndTime: Formato de fecha y hora corta como 'm/d/yy h:mm'.LongDate1: Fecha larga con mes, día, año como 'd-mmm-yy'.LongDate2: Fecha larga con día y mes abreviado como 'd-mmm'.LongDate3: Fecha larga con mes abreviado y año como 'mmm-yy'.Fraction1: Valores fraccionarios con un dígito como '# ?/?'.Fraction2: Valores fraccionarios con dos dígitos como '# ??/??'.Scientific1: Notación científica con un decimal como '##0.0E+0'.Scientific2: Notación científica con dos decimales como '0.00E+00'.Percent: Porcentaje sin decimales como '0%'.Percent2: Porcentaje con dos decimales como '0.00%'.Currency0: Moneda sin decimales, paréntesis para negativos como '$#,##0_);($#,##0).'Currency0Red: Moneda sin decimales, rojo para negativos como '$#,##0_);Red.'Currency2: Moneda con dos decimales, paréntesis para negativos como '$#,##0.00;($#,##0.00).'Currency2Red: Moneda con dos decimales, rojo para negativos como '$#,##0.00_);Red.'Thousands0: Números con separador de miles, sin decimales como '#,##0'.Thousands2: Números con separador de miles, dos decimales como '#,##0.00'.Number0: Números sin decimales como '0'.Number2: Números con dos decimales como '0.00'.Text: Formato de texto simple como '@'.
El formato de datos y el formato numérico en Excel controlan cómo se muestran los números, las fechas, las horas y otros datos en las celdas, mejorando la legibilidad y garantizando la precisión de los datos. Con los formatos de datos, puedes presentar la información en formatos específicos como porcentajes o monedas. Los formatos de números permiten personalizar los decimales y las opciones de visualización.
¿Cómo aplico varios formatos a distintos rangos?
En las aplicaciones del mundo real, a menudo es necesario aplicar distintos formatos a varias partes de la hoja de cálculo. Este ejemplo muestra cómo dar formato a un informe financiero con múltiples tipos de datos. Este enfoque es especialmente útil cuando se exporta a Excel en C# desde bases de datos u otras fuentes de datos:
- Usará el renderizador WebKit antiguo por defecto
using IronXL;
using IronXL.Formatting;
using System;
// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;
// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;
// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;
// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;
// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;
// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");Imports IronXL
Imports IronXL.Formatting
Imports System
' Create a financial report with multiple formats
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Headers
workSheet("A1").Value = "Financial Report Q4 2023"
workSheet("A1").Style.Font.Bold = True
' Revenue section with currency formatting
workSheet("A3").Value = "Revenue"
workSheet("B3").Value = 2500000
workSheet("B3").FormatString = BuiltinFormats.Currency0
' Growth percentage
workSheet("A4").Value = "YoY Growth"
workSheet("B4").Value = 0.157
workSheet("B4").FormatString = BuiltinFormats.Percent2
' Date formatting
workSheet("A6").Value = "Report Date"
workSheet("B6").Value = DateTime.Now
workSheet("B6").FormatString = BuiltinFormats.LongDate1
' Apply accounting format to expense columns
Dim expenseRange As IronXL.Range = workSheet("B8:B12")
expenseRange.FormatString = BuiltinFormats.Accounting2Red
' Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx")Este ejemplo muestra cómo se combinan distintos tipos de formato para crear documentos financieros profesionales. Para opciones de formato más avanzadas, como formato condicional, puede ampliar estos conceptos.
Cuando se trabaja con grandes conjuntos de datos o se crean informes mediante programación, es fundamental que el formato sea coherente. El sistema de formato de IronXL se integra a la perfección con otras características como funciones matemáticas y editar fórmulas, lo que permite crear soluciones de informes totalmente automatizadas.
Para los desarrolladores que migran desde Office Interop o que buscan un mejor rendimiento, el sistema de formato de IronXL proporciona una ventaja significativa. A diferencia de los enfoques tradicionales, puede dar formato a miles de celdas de manera eficiente sin sobrecarga de interoperabilidad COM. Para obtener más información sobre las mejores prácticas de automatización de Excel, explore nuestra completa Documentación de Excel.
Preguntas Frecuentes
¿Cómo puedo formatear celdas de Excel en C# sin usar Interop?
IronXL proporciona una forma sencilla de dar formato a las celdas de Excel sin dependencias de Interop. Puede utilizar la propiedad FormatString en celdas o rangos para aplicar formatos integrados como moneda, porcentajes, fechas y formatos numéricos personalizados. Sólo tiene que crear o abrir un libro con IronXL y establecer la propiedad FormatString en el formato que desee.
¿Cuál es la forma más rápida de aplicar formato de moneda a una celda?
Con IronXL, puede aplicar el formato de moneda en una sola línea de código. Después de crear un libro de trabajo, simplemente use: book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2; Esto aplica el formato de moneda incorporado con 2 decimales a la celda B2.
¿Puedo formatear varias celdas a la vez?
Sí, IronXL le permite dar formato a celdas individuales, columnas enteras, filas o cualquier rango seleccionado a través de la propiedad FormatString. Esta flexibilidad facilita la aplicación de un formato coherente en varias celdas de la hoja de cálculo de Excel sin tener que iterar en cada celda individualmente.
¿Cómo puedo evitar la conversión automática de datos al establecer los valores de las celdas?
IronXL proporciona la propiedad StringValue para establecer valores de celda como cadenas sin conversión automática. En lugar de utilizar la propiedad Value, utilice StringValue para asignar el valor exacto a la celda. Esto funciona de manera similar a colocar un apóstrofo antes del valor de la celda en Excel y es particularmente útil para códigos de producto, números de teléfono u otros datos que deben permanecer como texto.
¿Qué opciones de formato integradas hay disponibles?
IronXL ofrece una amplia colección de cadenas de formato predefinidas a través de la clase IronXL.Formatting.BuiltinFormats. Estos incluyen varios formatos de moneda, formatos de fecha y hora, visualización de porcentajes, notación científica y formatos numéricos personalizados, lo que le permite personalizar cómo se muestran los datos en sus hojas de cálculo de Excel.
¿Necesito instalar Microsoft Excel para utilizar las funciones de formato de celda?
No, IronXL funciona de forma independiente sin requerir dependencias de Microsoft Excel o Interop. La biblioteca incluye su propio motor de formato que manipula directamente los archivos de Excel, por lo que es ideal para entornos de servidor o sistemas en los que Excel no está instalado.
Does IronXL offer any performance benefits over Interop for Excel formatting?
IronXL provides significant performance improvements over traditional Interop by eliminating COM interop overhead, allowing efficient formatting of thousands of cells without relying on Office components.
How does IronXL's formatting enhance Excel reporting in C#?
IronXL’s formatting system integrates seamlessly with math functions and formula edits, making it invaluable for creating fully automated Excel reports programmatically.
What is a quick way to start using IronXL for formatting Excel cells?
To get started with IronXL, download the C# library, create a new or open an existing Excel worksheet, set the `FormatString` property to the desired format, and export your edited spreadsheet.
How does IronXL support data format customization?
Besides built-in formats, IronXL allows you to define custom formats using the `FormatString` property, providing flexibility when presenting specific types of data in Excel cells.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
