Usar IronXL con Asistentes de Programación IA
IronXL es una biblioteca .NET de Iron Software para trabajar con archivos de Excel. Crea, lee y edita libros de trabajo XLSX y XLS heredados, importa archivos CSV y TSV, evalúa fórmulas y dibuja gráficos, todo sin tener Microsoft Office instalado. IronXL ha estado disponible en NuGet desde 2019, y sus tutoriales utilizan WorkBook y WorkSheet a lo largo de todo el documento.
Los nombres de las clases no muestran cómo el lanzamiento 2026.10.1 trata tus datos. Dale a IronXL la cadena "8.27" como un valor de celda y almacenará el 27 de agosto del año actual. Importa un CSV con conversión de campo activada y un OrderId de 000417 regresa como el número 417. Guarda sin llamar a EvaluateAll y el archivo puede contener un resultado de fórmula de antes de la última edición. Ninguno de estos detiene una compilación.
Esta página configura cualquier asistente para ese tipo de trabajo.
- Los asistentes de estilo chat reescriben el código que seleccionas o responden desde el editor.
- Agentes como ChatGPT Codex, Google Antigravity, Claude Code y Cursor toman una tarea completa, luego construyen y ejecutan el código que escribieron.
La configuración es la misma para ambos, ya sea que el trabajo sea leer una exportación CSV, editar fórmulas, agregar un gráfico, o encriptar un libro de trabajo.
Cómo Usar IronXL con un Asistente de Programación IA
- Obtén el paquete IronXL.Excel de NuGet
- Asigna
IronXL.License.LicenseKeydesdeIronXL_LICENSE_KEYantes de la primera llamada al libro de trabajo - Proporciónale al asistente el índice
llms.txtde IronXL al inicio de la sesión - Mantén las reglas de IronXL en el archivo de instrucciones que carga tu asistente
- Abre una nueva sesión y envía el mensaje inicial de una vez
- Construye y ejecuta el programa, luego envía el mensaje de autoverificación
¿No Puede Mi Asistente de IA Manejar Excel Por Sí Solo?
De memoria, un asistente escribe el IronXL que vio en el entrenamiento, lo cual puede incluir miembros que el lanzamiento actual no tiene. IronXL publica su documentación en un formato que las herramientas pueden leer, por lo que el asistente puede trabajar desde la API actual en su lugar.
Escribir una cuadrícula de números en XLSX es la parte fácil. Las diferencias entre bibliotecas aparecen con fórmulas, entradas XLS heredadas, archivos CSV de proveedores y libros de trabajo que deben permanecer cerrados a extraños.
- Office Interop vincula el código a un escritorio: Un asistente que recurre a Interop necesita Excel instalado dondequiera que el código se ejecute, mientras que el paquete IronXL se ejecuta en servidores Windows, Linux y macOS.
- Reescribir el analizador CSV cuesta tokens: Un agente que reemplace la importación CSV de IronXL con un separador escrito a mano después de una importación incorrecta paga por cada intento, y el nuevo analizador todavía tiene que aprender las reglas de comillas que IronXL ya maneja.
- El nombre del paquete y el espacio de nombres son diferentes: El ID de NuGet es
IronXL.Excely el espacio de nombres esIronXL. Un ID adivinado puede resolverse en un paquete similar publicado para captar esa adivinanza, el ataque llamado slopsquatting. Escribe el ID exacto en la solicitud.
Paso 1: Instalar IronXL
Con el paquete referenciado, el asistente puede inspeccionar los tipos reales de IronXL.
Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
Para fijar una versión desde la terminal en su lugar, nombrala.
dotnet add package IronXL.Excel --version 2026.10.5
IronXL.Excel 2026.10.5 depende solo de IronSoftware.Common y IronSoftware.System.Drawing.
Paso 2: Aplique su clave de licencia
IronXL no vuelve a un modo con marca de agua o limitado. Sin una clave, crear, cargar o importar un libro de trabajo lanza IronSoftware.Exceptions.LicensingException con el mensaje Licencia de Producción Requerida. Con una clave mal escrita, la primera llamada falla con Clave de Licencia No Reconocida en su lugar. Una clave de prueba gratuita está abajo, y la página de licencias da el desarrollador, la ubicación y los conteos de proyecto para cada nivel de licencia perpetua.
Empiece a usar IronXL en su proyecto hoy con una prueba gratuita.
Establece la clave una vez cuando el programa comienza, antes de cualquier otra llamada a IronXL, y extráela de la variable de entorno IRONXL_LICENSE_KEY, lo que la mantiene fuera del control de fuente.
IronXL.License.IsLicensed devuelve verdadero después de aplicar una clave válida, y IronXL.License.IsValidLicense informa si una clave dada es válida y no ha expirado. El tipo de excepción es interno, por lo que una cláusula catch que la nombre no compila e informa CS0122. Verifica IsLicensed al inicio, o atrapa Exception y lee el mensaje.
Web.config o appsettings.json en su lugar.Paso 3: Dirije tu Asistente a la Documentación LLM de IronXL
llms.txtes un índice vinculado con una línea por página, y pertenece al inicio de cada sesión.- Resúmenes de 94 páginas llegan en un archivo en
llms-full.txt, lo cual conviene para preguntas generales. llms-full-catalog.txtañade cada publicación de blog al índice, para comparaciones y recorridos de blog.- La Referencia de API enumera cada espacio de nombres, tipo y miembro.
- Herramientas que cargan archivos de habilidad pueden tomar
skill.md, que cubre instalación, licencias, recetas y fallos comunes. - La Ficha Técnica del Producto AI proporciona una página de contexto.
Fetch https://ironsoftware.com/excel/csharp/llms.txt before you write any spreadsheet code.
Stick to IronXL members that the index documents.
- Open workbooks with WorkBook.Load or WorkBook.Create.
- Import delimited text with WorkBook.LoadCSV and an explicit delimiter.
- Save with SaveAs.
Look up any member the index lacks at https://ironsoftware.com/excel/csharp/object-reference/api/.
If it's missing there too, tell me instead of making one up.
Cuando una tarea depende de una guía, pide al asistente abrir esa página.
Paso 4: Añade Contexto de IronXL a tu Proyecto
Las instrucciones de chat desaparecen cuando el chat se cierra. Un archivo de proyecto se lee nuevamente cada vez que se abre una sesión, así que agrega las reglas de IronXL a la que tu equipo ya conserva. Claude Code lee CLAUDE.md, ChatGPT Codex lee AGENTS.md, y GitHub Copilot lee .github/copilot-instructions.md. Cursor lee archivos .mdc en .cursor/rules/, o AGENTS.md. Google Antigravity lee AGENTS.md o GEMINI.md. Las reglas se leen igual en cada archivo.
## Spreadsheets with IronXL
All Excel, CSV, and TSV work in this repo uses IronXL.
The NuGet package is `IronXL.Excel`. Its namespace is `IronXL`.
Number formats live in `IronXL.Formatting` and charts in `IronXL.Drawing.Charts`.
- Read the docs index at https://ironsoftware.com/excel/csharp/llms.txt.
- Read the skill file at https://ironsoftware.com/excel/csharp/skill.md.
- Set `IronXL.License.LicenseKey` from IRONXL_LICENSE_KEY at startup.
- Never write the key into a file.
- Import CSV with `WorkBook.LoadCSV`, passing the path, an XLSX format, and the delimiter.
- Choose `convertFieldValues` on purpose. Conversion strips leading zeros from ID columns.
- A numeric string such as "8.27" assigned to `Value` becomes a date.
- Write numbers as numbers and dates as `DateTime`.
- Call `EvaluateAll` before `SaveAs` so the file stores current formula results.
- Encrypt with `WorkBook.Password` or `SaveAs` with a password. `ProtectSheet` only locks editing.
- Save XLSX unless a task names XLS.
- Before calling a change done, reload every saved workbook.
- Compare the reloaded values with the source data.
- Add no Office Interop and no second spreadsheet library.
- If IronXL lacks a feature, ask before adding anything.
El archivo de habilidades maneja correctamente la encriptación, la protección de la hoja y EvaluateAll. No advierte sobre los ceros iniciales o la conversión de fecha, así que mantiene esas dos líneas en tu propio archivo. Su ejemplo de archivo único sigue fijando 2026.8.1, tres versiones detrás del paquete 2026.10.5 en NuGet, así que actualiza la fijación a la versión que tu proyecto utiliza.
Paso 5: Prompt de Configuración de Un Solo Paso
Los pasos 1 al 4 encajan en un mensaje. Envíalo cuando comience un proyecto o en cualquier nueva sesión.
Set this project up for spreadsheet work with IronXL.
Store the rules below in the instructions file your later sessions load.
- Reference the IronXL.Excel NuGet package. Its namespace is plain IronXL.
- Read IRONXL_LICENSE_KEY into IronXL.License.LicenseKey at startup, before any WorkBook call.
- Never copy the key into a file.
- Before writing code, fetch https://ironsoftware.com/excel/csharp/llms.txt.
- Build only on members it documents.
- Look up anything else in the API reference before you rely on it.
- If you support skill files, load https://ironsoftware.com/excel/csharp/skill.md.
- When the compiler and the skill disagree, believe the compiler.
- Whenever code saves a workbook, open the saved file again.
- Compare the reopened file's cells and formula results with the data that went in.
Paso 6: Patrones de Prompt que Producen Código Funcional
Nombra la hoja, las celdas y el formato. El asistente no puede adivinar qué celdas importan o qué formato de archivo necesita el trabajo.
Vago Convierte nuestros pedidos en un informe de Excel con IronXL.
Mejor Crea el libro de trabajo con
WorkBook.Create(ExcelFileFormat.XLSX), escribe los pedidos en una hoja llamada Orders con una fila de encabezado en negrita y congelada, aplicaBuiltinFormats.Currency2a la columna UnitPrice, y coloca un SUMIF por región en una hoja de Summary.
Indica la versión y el framework. El comportamiento cambia entre versiones, y un asistente sin una versión puede mezclar lo viejo y lo nuevo.
Mejor Apunta a .NET 9 y IronXL.Excel 2026.10.5.
Pide archivos completos. Un fragmento pierde sus directivas de using, lo que importa porque BuiltinFormats se encuentra en IronXL.Formatting y ChartType en IronXL.Drawing.Charts.
Mejor Devuelve el
Program.cscompleto con cada directiva using y la asignación de licencia, para que compile tal como está.
Paso 7: Verifica lo que Recibes
Cada uno de estos errores se reproduce en 2026.10.1.
- Un
Rangeambiguo: Con usings implícitos, asignar un rango de hoja comoA1:B2a una variableRangecoincide con ambosIronXL.RangeySystem.Rangey falla con CS0104. EscribeIronXL.Range, o añade un alias. - Miembros de la celda llamados en un rango: Indexar una única celda como
A1todavía devuelve unIronXL.Range, por lo que llamar aAddCommenten ese resultado falla con CS1061. Llama aFirstpara llegar alCell. - El lector incorrecto para un archivo con punto y coma:
WorkBook.Loaddividió un archivo de comas en columnas, pero colocó cada línea completa de un archivo con punto y coma en la columna A y lanzó FileLoadException en un archivo con punto y coma con campos entrecomillados. Pasa el delimitador aWorkBook.LoadCSV, como lo hace la guía de lectura CSV.
Deja que el Agente Verifique su Propio Trabajo
Rebuild in Release and run the program. Then check the result yourself:
- Name the documentation page behind each IronXL member you used.
- Print IronXL.License.IsLicensed.
- Reopen every workbook the program saved.
Give me a table of file, cell, value expected, value found, and whether they agree.
Conversión de Campos CSV y Valores de Celdas
La conversión de tipos ocurre en dos lugares. Estos resultados son de IronXL.Excel 2026.10.1 en .NET 9.
WorkBook.LoadCSV toma una bandera convertFieldValues, y su valor predeterminado es verdadero.
| Campo en el CSV | Conversión activada | Conversión desactivada |
|---|---|---|
| 000417 (ID) | número 417 | texto 000417 |
| 12.50 (precio) | número 12.5 | texto 12.50 |
| 2026-08-30 (fecha) | texto | texto |
| 2 después de "Monitor 27"" mate" | texto | texto |
| "Tornillo; M8 zinc" | un campo | un campo |
El entrecomillado funciona como describe RFC 4180, y nombres en UTF-8 como Café con un acento sobrevivieron la importación con o sin un marca de orden de bytes. La fila con una comilla escapada mantuvo su siguiente número como texto, y SUM y SUMIF omiten texto, mientras que una fórmula que multiplicó las mismas celdas aún funcionó.
El segundo lugar es el setter Value. Una cadena asignada como un valor de celda es analizada, y las cadenas con forma de mes y día se convierten en fechas. En nuestras pruebas, "1.5" se almacenó como el 5 de enero de 2026 y "2026-08-30" como el 30 de agosto de 2026, mientras que "12.50" y "000417" se mantuvieron como texto.
Por lo tanto, una importación que copia campos CSV como cadenas puede convertir un precio de 8.27 en un número de serie de fecha cerca de 46,261. El patrón seguro es importar con la conversión desactivada, analizar cada columna con la cultura invariable y asignar valores int, decimal, double, o DateTime.
Resultados de Fórmulas en el Archivo Guardado
IronXL calcula las fórmulas cuando las lees, por lo que una verificación que recargue el libro de trabajo a través de IronXL siempre ve una respuesta actual. El archivo guardado es otro asunto. Lectores que no calculan, como openpyxl y pandas, solo ven los resultados que el archivo almacena.
En nuestras pruebas, una fórmula que nunca fue leída o evaluada antes de que SaveAs fuera escrito no se guardó con un resultado almacenado. Una fórmula leída una vez, seguida de un cambio en su entrada y un guardado, mantuvo el resultado antiguo en el archivo. IronXL informó el nuevo total de 43 después de recargar, mientras que openpyxl leyó el almacenado 5. Después de EvaluateAll y luego SaveAs, cada fórmula llevó su valor actual. La guía de edición de fórmulas llama a EvaluateAll por la misma razón.
Las referencias entre hojas funcionan como se espera. Un SUMIF en una hoja de Summary sobre rangos de la hoja Orders se evaluó correctamente, se guardó y se recargó como una fórmula con su valor.
Texto de Fórmula Devuelto por IronXL
Una verificación de que cada fila de Orders contenga su fórmula de Revenue puede comparar el texto de la fórmula, pero IronXL no devuelve la cadena que se le dio. Asignamos =E2*F2 en la celda G2 con 2026.10.1, y la propiedad Formula devolvió E2*F2 sin el signo igual, tanto antes de guardar como después de recargar. Ese es el contenido del elemento fórmula en el XML de la hoja. La propia documentación XML de IronXL para Cell.Formula da =A2+A2+A3+A4 como su ejemplo, y la guía de edición de fórmulas escribe fórmulas pero solo lee sus resultados.
Una fórmula escrita sin el signo igual se lee de vuelta sin cambios, y una asignada a través de Value pierde su signo igual de la misma manera. Una celda que contiene un número simple devuelve null. IronXL mantiene el caso y espaciado que se le dio, por lo que =e5 * f5 se lee de vuelta como e5 * f5.
Por lo tanto, una autoverificación que compara el texto de la fórmula con =E2*F2 falla en un libro de trabajo correcto. En el mensaje a continuación, un fallo falso de ese tipo enviaría al agente de vuelta al paso 11 para cambiar el código del informe que ya estaba correcto.
Columnas enteras tienen una segunda trampa. La propiedad Formula en un rango de múltiples celdas devuelve null a menos que cada celda contenga la misma fórmula. El rango G2:G5 fue null para cuatro fórmulas correctas por fila, la misma respuesta que dio para E2:E5, que no contiene ninguna fórmula en absoluto. Prueba IsFormula en cada Cell, y compara el texto de la fórmula solo después de remover el = de la cadena esperada.
Límites de Salida XLS
Sistemas de pedidos y contabilidad más antiguos todavía exportan XLS, e IronXL lo lee y escribe. Escribirlo tiene límites que XLSX no tiene.
| Operación | XLSX | XLS en 2026.10.1 |
|---|---|---|
| Filas | 1,048,576, luego lanza una excepción | 65,536, luego ArgumentException |
| Gráficos | funciona | Excepción, el mensaje recomienda XLSX |
Password, Encrypt, o SaveAs con una contraseña | encripta | ArgumentException, solo .xlsx, .xlsm, .xltx |
| Texto 000501 | texto | texto |
DateTime | fecha | fecha, IsDateTime verdadero después de recargar |
Un archivo XLS que IronXL escribe es un libro de trabajo genuino de Excel 97-2003. Sus primeros ocho bytes son D0 CF 11 E0 A1 B1 1A E1, la firma del archivo compuesto, que es una manera rápida de confirmar que un asistente no guardó contenido XLSX bajo un nombre .xls.
Protección de Hojas y Encriptación de Archivos
Pide un "libro de trabajo protegido con contraseña" y un asistente puede elegir cualquiera de dos funciones de IronXL. Se comportan de manera diferente.
| Guardado con | Primeros bytes | Sin contraseña | Contraseña incorrecta |
|---|---|---|---|
ProtectSheet con Q3-review en cada hoja | 50 4B 03 04 (ZIP) | abre | abre |
WorkBook.Password, SaveAs con una contraseña, o Encrypt, luego SaveAs | D0 CF 11 E0 (encriptado) | ArgumentNullException | SecurityException, Contraseña inválida |
Los cuatro abren con la contraseña correcta. ProtectSheet está destinado a detener ediciones dentro de Excel, y no encripta nada. Cuando el requisito es que los extraños no puedan leer el archivo, pide encriptación por nombre, como lo hace la guía de contraseñas de libros de trabajo. Encrypt también devuelve el libro de trabajo encriptado como un flujo y almacena la contraseña en el libro, por lo que SaveAs que sigue escribe un archivo encriptado. WorkBook.Load con una contraseña abre el resultado.
Un Resultado que Puedes Reproducir
La prueba es un mensaje y ningún código tuyo. Abre una sesión nueva en una carpeta vacía, pega el mensaje y compara lo que regresa con la lista de aciertos debajo.
IRONXL_LICENSE_KEY.El prompt
Write a .NET 9 console program that merges two order exports into a regional sales workbook.
The working directory should be empty.
If a project or any source file is already there, tell me and stop.
Nobody can answer questions, so write, build, run and repair the program yourself.
Note every assumption you settle on, and put all deliverables in the project root.
1. Install the IronXL.Excel NuGet package pinned to version 2026.10.1.
Don't add any other release.
2. Use https://ironsoftware.com/excel/csharp/llms.txt and the guides it links as your reference.
Call no IronXL member they leave out.
3. At startup, assign IronXL.License.LicenseKey from the IRONXL_LICENSE_KEY environment variable.
Don't let the key appear in any file in the project folder.
The program reads that variable itself, so never print its value.
Don't list environment variables either.
If IronXL.License.IsLicensed is false, say so and exit.
4. Write a generator for the two input files.
Use random seed 2026, and create the inputs only when they're absent.
Every order in both files follows these rules:
- OrderIds are six digits with leading zeros.
- They count up from 000101 and never repeat across the two files.
- Dates fall between July 1 and September 30, 2026.
- Regions are North, South, East, and West in unequal shares.
- Quantity is 1 to 40.
- Every UnitPrice has cents other than .00.
Products come from a catalog of eight or more names.
At least two names contain each of these:
- A semicolon.
- A double quote.
- A letter outside ASCII. An accented e or a German sharp s will do.
orders.csv holds 200 orders in this shape:
- It's UTF-8 and semicolon-delimited.
- Its header is OrderId;Date;Region;Product;Quantity;UnitPrice.
- It quotes the fields with those characters in RFC 4180 style.
legacy.xls is a genuine Excel 97-2003 workbook written by IronXL.
It holds 50 further orders under the same six headers, stored like this:
- OrderId cells are text.
- Date cells are dates.
- Quantity and UnitPrice cells are numbers.
Then write manifest.csv from the generator's in-memory records:
- It's comma-delimited and quoted in the same RFC 4180 style.
- Each order gets one row with its source file and all six values.
5. Measure the inputs before the first load.
Whenever a figure falls outside its range, fix the generator and generate the inputs again.
orders.csv needs exactly 200 data rows.
Count these three kinds of rows in it separately. Each count must be 15 or more:
- Rows with a semicolon in Product.
- Rows with a double quote.
- Rows with a non-ASCII letter.
Then measure these figures:
- OrderIds that start with 0: all 250.
- Prices with cents other than .00: 225 or more.
- The first eight bytes of legacy.xls: D0 CF 11 E0 A1 B1 1A E1.
- Order counts per region: four different numbers.
- Revenue per region: every two regions at least 1,000 apart.
Once the program has loaded the inputs for the first time, orders.csv and legacy.xls are frozen.
Don't rewrite or edit them.
6. Load both inputs and save sales-report.xlsx.
Its Orders sheet holds all 250 orders under the six input headers plus Revenue:
- OrderId is text.
- OrderId, Region and Product are identical to the input.
- Date is a date, and Quantity and UnitPrice are numbers.
- Revenue is a formula multiplying Quantity by UnitPrice in every row.
The Summary sheet has the columns Region, Units, and Revenue:
- It has one row per region with Units and Revenue as SUMIF formulas over the Orders sheet.
- A Total row of SUM formulas follows the region rows.
- Add a column chart of revenue by region to Summary.
Give Revenue a currency format.
Make the header row bold and frozen on both sheets.
The saved file must hold every formula's current result.
That way a reader that never calculates formulas sees the same figures.
7. The import is one fixed procedure.
The procedure has these rules:
- Use one IronXL load call with set options per file.
- Don't parse any input file by hand.
- Apply one conversion rule per column to every row.
Loading and report code may not do any of these things:
- Open manifest.csv.
- Hold an OrderId, product name, quantity or price as a literal.
- Compare a cell with an expected value.
- Patch individual rows.
Only the round-trip code reads the manifest.
Changing the procedure between runs is your job and never the program's.
8. Save sales-report-protected.xlsx, a copy that no one can open without the password Q3-review.
Encrypt the file. Locking sheets doesn't count.
9. Build in Release and run.
10. Reload both workbooks through IronXL and write roundtrip.md.
Start with each step 5 measurement as a number, then describe the import procedure.
After that, add a table with the columns check, expected, actual, and match.
The table has 16 rows, in this order:
- The Orders row count.
- Units for each region, then revenue for each region.
- Total units and total revenue.
- How many OrderIds and how many product names in Orders match the input exactly, 250 each.
- The number of charts on Summary.
- Whether the protected copy refuses both no password and a wrong one.
- Whether Q3-review opens it with 250 orders.
Expected figures come from the manifest, and actual figures from the reloaded workbooks.
Money must agree to the cent and the rest exactly.
11. Repair the program while any of the 16 rows fails.
Each time, read the failing rows and change the import or report code.
Then build and execute the program once more.
If the eighth execution still leaves failures, stop.
List those rows, every import procedure you tried, and your explanation of the cause.
When you're done, tell me these things, even if you stopped at step 11:
- The build result.
- The number of rows matched.
- The import procedure.
- The step 5 figures.
- Your assumptions.
Calibramos el mensaje con un programa de referencia en IronXL 2026.10.1 y semilla 2026. Importar a través de LoadCSV con formato XLSX, un delimitador de punto y coma, y conversión de campos activada, luego copiando los valores convertidos, coincidió con 9 de 16 filas. Todos los 200 OrderIds del CSV perdieron sus ceros iniciales, y las unidades de cada región se quedaron cortas porque 48 cantidades después de una comilla escapada se mantuvieron como texto. Importar con conversión desactivada y copiar las cadenas coincidió con 8 de 16, porque los precios 8.27 y 10.11 se convirtieron en fechas, lo que llevó los ingresos del norte a 3.9 veces su valor real y los del sur a 2.9 veces. Analizar cada columna explícitamente y escribir valores tipificados coincidió con 16 de 16 en semillas 2026, 77, 4101, y 12345. Un borrador anterior de este mensaje pasó 9 de 9 en IronXL 2026.9.2 con nombres de productos en ASCII simple, IDs numéricos desnudos y totales heredados leídos por el mismo código que construyó el informe, por lo que probó poco.
Resultado
Esta imagen es una representación de la hoja Summary en el sales-report.xlsx de la ejecución, obtenida de los valores y el gráfico que el archivo guardado almacena, y no una captura de pantalla tomada en Excel. La tabla de ida y vuelta sin editar de la ejecución contiene cada medición del paso 5, el procedimiento de importación y las 16 filas.
- La primera ejecución del programa se detuvo en la verificación del paso 5, porque el norte y el sur ambos tenían 90 pedidos y sus ingresos estaban separados por 921.94. Claude Code amplió las participaciones regionales, generó las entradas de nuevo y coincidió con todas las 16 filas en la siguiente ejecución, por lo que el bucle de reparación en el paso 11 nunca se ejecutó.
- En el
orders.csvde esta ejecución, una carga con conversión activada no conservó ninguno de los 200 OrderIds como texto con un cero inicial y dejó 38 cantidades como texto, por lo que la importación obvia también habría fallado aquí. - Antes de escribir el programa, Claude Code probó la importación CSV de IronXL en una carpeta de borrador y eligió el procedimiento seguro desde el principio. Carga el XLS con
WorkBook.Loady da a cada columna una regla que prueba el propio tipo de la celda. - Las entradas midieron 200 pedidos CSV, con 43 productos que contienen un punto y coma, 38 una comilla escapada, y 48 una letra no ASCII, y 9 de 9 medidas del paso 5 cayeron dentro del rango.
- Summary contiene 8 fórmulas SUMIF y 2 SUM con totales almacenados de 5,337 unidades y $549,169.80, además de un gráfico de columnas. La copia encriptada se abre con Q3-review a 250 pedidos.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Claude Code contó las filas del CSV desde el propio archivo pero tomó las cifras que abarcan ambos archivos de los registros del generador, mientras que
roundtrip.mddice que vinieron de los archivos de entrada. Cargó ambas entradas a través deLoadingOptions, que ninguna página dellms.txtdocumentos enlaces, y verificó la clave conenv | grep -c, que enumera las variables de entorno en un conteo. Los mensajes de los pasos 1, 3, 5 y 7 siguieron en la misma sesión. La instalación mantuvo el pin en 2026.10.1. El mensaje de documentación encontróPhysicalRowCountsolo en la referencia de API y reemplazóLoadingOptionsconWorkBook.LoadCSVyWorkBook.Load, por lo que el archivo de ida y vuelta publicado describe esa importación. Coincidió con 16 de 16 de nuevo. El mensaje de configuración escribió las reglas enCLAUDE.mdy guardóskill.mdcomo una habilidad del proyecto. La autoverificación nombró una página de documentación para cada miembro, encontró 69 de 69 celdas muestreadas en acuerdo, y coincidió con las 250 filas de cada libro de trabajo con el manifiesto. Medimos cada criterio de aprobación nuevamente en los archivos guardados sin IronXL, y una construcción de Release nueva del programa produjo la misma tabla.
Lo que pasa
- El proyecto se compila en Release sin ediciones manuales.
- Todas las 16 filas de
roundtrip.mdcoinciden, y sus cifras regionales y totales igualan los totales de los archivos de entrada. - Una búsqueda en la carpeta del proyecto no encuentra la clave de licencia en ningún archivo.
El récord de ejecución
- Las ejecuciones utilizan un escritorio Windows 11 x64 con un Core i9-14900KF y 64 GB de memoria.
- Cada proyecto apunta a .NET 9.
- Cada guía utiliza
IronXL.Excel2026.10.1 como su único paquete IronXL, excepto la guía de Claude Code, cuya ejecución instaló 2026.10.5. ChatGPT Codex añadióMicrosoft.Extensions.DependencyInjection9.0.20 a su convertidor, y los proyectos de prueba de Codex, Copilot, Cursor, y Antigravity se ejecutan en xUnit. - La duración de una guía es la suma de los tiempos registrados de los mensajes en su página, y la fila de esta guía cuenta solo el mensaje de aceptación.
- Última prueba: 15 de octubre de 2026, con la ejecución de esta guía. Google Antigravity fue probado el 14 de octubre. Claude Code y GitHub Copilot fueron probados el 13 de octubre, Cursor el 9 de octubre, y ChatGPT Codex el 7 de octubre de 2026.
| Guía | Asistente y versión | Modelo | Duración (minutos) |
|---|---|---|---|
| Esta guía | Claude Code 2.1.277, una sesión, mensajes de permiso desactivados | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, mensaje 3 en modo plan | Claude Sonnet 5, con Claude Opus 5 para el mensaje 3 | 53.8 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 59.0 |
| GitHub Copilot | GitHub Copilot CLI 1.0.97 | GPT-6 Luna, dirigido por Auto | 14.5 |
| Cursor | Aplicación de escritorio Cursor 3.23.23 | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 3.8 Flash (Alto) | 44.9 |
Guías Específicas del Agente
Cada guía a continuación aplica los pasos anteriores a una herramienta y un trabajo de hoja de cálculo.
- Usa IronXL con Claude Code para leer libros de trabajo con un millón de filas con transmisión solo hacia adelante, con memoria y tiempo medidos contra una carga completa del libro de trabajo
- Usa IronXL con ChatGPT Codex para convertir una carpeta de archivos mezclados de XLS, XLSX, CSV, y TSV a CSV, JSON y XML, con una fila de resultados para cada entrada y manejo para archivos corruptos o protegidos
- Usa IronXL con GitHub Copilot para dar estilo a la salida de una solución de informes existente, con pruebas que recargan cada libro de trabajo y asertan sus formatos
- Usa IronXL con Cursor para mover el código de edición de libros de trabajo fuera de Office Interop, bajo reglas que mantienen fuera las llamadas a Interop y EPPlus
- Usa IronXL con Google Antigravity para una página de ASP.NET Core que previsualiza, valida y limpia un libro de trabajo subido, demostrado por cargas en una sesión de navegador en vivo
Solución de problemas
- Límites de Tamaño de Archivo de IronXL cuando un libro de trabajo XLS se queda sin filas
- Aplica una Clave de Licencia en IronXL una vez que la primera llamada al libro de trabajo lanza LicensingException
- FileNotFoundException para IronXL.XmlSerializers en .NET 10 cuando un depurador se detiene dentro de la llamada de guardado aunque el archivo esté escrito
¿Preguntas?
Si tienes alguna pregunta, contacta a support@ironsoftware.com
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.