Usando IronXL com Assistentes de Codificação com IA
IronXL é uma biblioteca .NET da Iron Software para trabalhar com arquivos Excel. Ele cria, lê e edita planilhas XLSX e XLS antigas, importa arquivos CSV e TSV, avalia fórmulas e desenha gráficos, tudo sem o Microsoft Office instalado. IronXL foi lançado no NuGet desde 2019, e seus tutoriais usam WorkBook e WorkSheet por toda parte.
Os nomes das classes não mostram como a versão 2026.10.1 trata seus dados. Dê ao IronXL a string "8.27" como um valor de célula e ele armazena 27 de agosto do ano atual. Importe um CSV com conversão de campo ativada e um OrderId de 000417 resulta no número 417. Salve sem chamar EvaluateAll e o arquivo pode manter um resultado de fórmula anterior à última edição. Nada disso interrompe uma build.
Esta página configura qualquer assistente para esse tipo de trabalho.
- Assistentes estilo chat reescrevem o código que você seleciona ou respondem a partir do editor.
- Agentes como ChatGPT Codex, Google Antigravity, Claude Code e Cursor pegam uma tarefa inteira, depois constroem e executam o código que escreveram.
A configuração é a mesma para ambos, seja a tarefa ler uma exportação CSV, editar fórmulas, adicionar um gráfico, ou criptografar uma planilha.
Como Usar IronXL com um Assistente de Codificação com IA
- Obtenha o pacote IronXL.Excel do NuGet
- Atribua
IronXL.License.LicenseKeydeIronXL_LICENSE_KEYantes da primeira chamada de planilha - Entregue ao assistente o índice
llms.txtdo IronXL no início da sessão - Mantenha as regras do IronXL no arquivo de instruções que seu assistente carrega
- Abra uma nova sessão e envie o prompt de configuração de uma só vez
- Construa e execute o programa, depois envie o prompt de auto-verificação
Meu Assistente de IA Não Pode Lidar com Excel Sozinho?
Somente pela memória, um assistente escreve o IronXL que viu no treinamento, o que pode incluir membros que a versão atual não possui. A IronXL publica sua documentação em um formato que as ferramentas podem ler, para que o assistente possa trabalhar a partir da API atual em vez disso.
Escrever uma grade de números em XLSX é a parte fácil. As diferenças entre as bibliotecas aparecem com fórmulas, entradas XLS antigas, arquivos CSV de fornecedores e planilhas que precisam permanecer fechadas para estranhos.
- Office Interop vincula o código a um desktop: Um assistente que procura Interop precisa do Excel instalado onde quer que o código seja executado, enquanto o pacote IronXL é executado em servidores Windows, Linux e macOS.
- Reescrever o analisador CSV custa tokens: Um agente que substitui a importação CSV do IronXL por um divisor escrito à mão após uma importação errada paga por cada tentativa, e o novo analisador ainda precisa aprender as regras de citação que o IronXL já lida.
- O nome do pacote e o namespace diferem: O ID do NuGet é
IronXL.Excele o namespace éIronXL. Um ID adivinhado pode resolver para um pacote similar publicado para capturar essa adivinhação, o ataque chamado slopsquatting. Escreva o ID exato no prompt.
Passo 1: Instale o IronXL
Com o pacote referenciado, o assistente pode inspecionar os tipos reais do IronXL.
Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
Para fixar uma versão a partir do terminal em vez disso, nomeie-a.
dotnet add package IronXL.Excel --version 2026.10.5
IronXL.Excel 2026.10.5 depende apenas de IronSoftware.Common e IronSoftware.System.Drawing.
Passo 2: Aplique sua chave de licença
IronXL não recai para um modo com marca d'água ou limitado. Sem uma chave, criar, carregar ou importar uma planilha lança IronSoftware.Exceptions.LicensingException com a mensagem Licença de Produção Requerida. Com uma chave digitada incorretamente, a primeira chamada falha com Chave de Licença Não Reconhecida. Uma chave de teste gratuita está abaixo, e a página de licenciamento fornece o desenvolvedor, a localização e a contagem de projetos para cada nível de licença perpétua.
Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita.
Defina a chave uma vez quando o programa iniciar, antes de qualquer outra chamada do IronXL, e extraia-a da variável de ambiente IRONXL_LICENSE_KEY, o que a mantém fora do controle de versão.
IronXL.License.IsLicensed retorna verdadeiro após uma chave válida ser aplicada, e IronXL.License.IsValidLicense informa se uma chave dada é válida e não expirada. O tipo de exceção é interno, então uma cláusula de captura que o nomeia não compila e relata CS0122. Verifique IsLicensed ao iniciar, ou capture Exception e leia a mensagem.
Web.config ou appsettings.json em vez disso.Passo 3: Aponte Seu Assistente para a Documentação LLM do IronXL
llms.txté um índice vinculado com uma linha por página, e pertence ao início de cada sessão.- Resumos de 94 páginas chegam em um arquivo em
llms-full.txt, o que atende perguntas amplas. llms-full-catalog.txtadiciona todas as postagens do blog ao índice, para comparações e guias do blog.- A Referência de API lista cada namespace, tipo e membro.
- Ferramentas que carregam arquivos de habilidade podem levar
skill.md, que cobre instalação, licenciamento, receitas e falhas comuns. - O Fato do Produto com IA fornece uma página de antecedentes.
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.
Quando uma tarefa depende de um guia, peça ao assistente para abrir essa página.
Passo 4: Adicione o Contexto do IronXL ao Seu Projeto
As instruções de chat desaparecem quando o chat fecha. Um arquivo de projeto é lido novamente sempre que uma sessão é aberta, então adicione as regras do IronXL ao que sua equipe já mantém. Claude Code lê CLAUDE.md, ChatGPT Codex lê AGENTS.md, e GitHub Copilot lê .github/copilot-instructions.md. Cursor lê arquivos .mdc em .cursor/rules/, ou AGENTS.md. Google Antigravity lê AGENTS.md ou GEMINI.md. As regras leem da mesma forma em cada arquivo.
## 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.
O arquivo de habilidade obtém de forma correta a criptografia, proteção de planilha e EvaluateAll. Não avisa sobre os zeros à esquerda ou a conversão de data, portanto, mantenha essas duas linhas no seu próprio arquivo. O exemplo de arquivo único ainda fixa 2026.8.1, três versões atrás do pacote 2026.10.5 no NuGet, então atualize a fixação para a versão que seu projeto usa.
Passo 5: Prompt de Configuração Única
Os passos 1 a 4 cabem em uma mensagem. Envie-a quando começar um projeto ou em qualquer nova sessão.
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.
Passo 6: Padrões de Prompt que Produzem Código Funcional
Nomeie a planilha, as células e o formato. O assistente não pode adivinhar quais células importam ou qual formato de arquivo o trabalho precisa.
Vago Transforme nossos pedidos em um relatório Excel com IronXL.
Melhor Crie a planilha com
WorkBook.Create(ExcelFileFormat.XLSX), escreva os pedidos em uma planilha chamada Orders com uma linha de cabeçalho congelada em negrito, apliqueBuiltinFormats.Currency2à coluna UnitPrice, e coloque um SUMIF por região em uma planilha Summary.
Forneça a versão e o framework. Comportamentos mudam entre versões, e um assistente sem uma versão pode misturar o antigo e o novo.
Melhor Mire no .NET 9 e no IronXL.Excel 2026.10.5.
Solicite arquivos completos. Um fragmento perde suas diretivas using, o que importa porque BuiltinFormats vive em IronXL.Formatting e ChartType em IronXL.Drawing.Charts.
Melhor Retorne o
Program.cscompleto com cada diretiva using e a atribuição de licença, para que ele compile como está.
Passo 7: Verifique o Que Você Obtém de Volta
Cada um desses erros se reproduz na versão 2026.10.1.
- Um
Rangeambíguo: Com usings implícitos, atribuir um intervalo da planilha comoA1:B2a uma variávelRangecorresponde tanto aIronXL.Rangequanto aSystem.Rangee falha com CS0104. EscrevaIronXL.Range, ou adicione um alias. - Membros da célula chamados em um intervalo: Indexar uma única célula como
A1ainda retornaIronXL.Range, então chamarAddCommentnesse resultado falha com CS1061. ChameFirstpara alcançar oCell. - O leitor errado para um arquivo de ponto e vírgula:
WorkBook.Loaddividiu um arquivo de vírgula em colunas, mas colocou cada linha inteira de um arquivo de ponto e vírgula na coluna A e lançou FileLoadException em um arquivo de ponto e vírgula com campos entre aspas. Passe o delimitador paraWorkBook.LoadCSV, como o guia de leitura CSV faz.
Deixe o Agente Verificar Seu Próprio Trabalho
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.
Conversão de Campo CSV e Valor de Célula
A conversão de tipos ocorre em dois lugares. Esses resultados são de IronXL.Excel 2026.10.1 em .NET 9.
WorkBook.LoadCSV leva uma bandeira convertFieldValues, e ela está definida para verdadeiro por padrão.
| Campo no CSV | Conversão ativada | Conversão desativada |
|---|---|---|
| 000417 (ID) | número 417 | texto 000417 |
| 12.50 (preço) | número 12.5 | texto 12.50 |
| 2026-08-30 (data) | texto | texto |
| 2 após "Monitor 27" fosco" | texto | texto |
| "Parafuso; M8 zinco" | um campo | um campo |
As aspas funcionam como descrito na RFC 4180, e nomes UTF-8 como Café com acento sobreviveram à importação com ou sem uma marca de ordem de byte. A linha com uma citação escapada manteve seu próximo número como texto, e SUM e SUMIF pulam texto, enquanto uma fórmula que multiplicou as mesmas células ainda funcionou.
O segundo lugar é o setter Value. Uma string atribuída como valor de célula é analisada, e strings com formato de mês e dia se tornam datas. Em nossos testes, "1.5" foi armazenado como 5 de janeiro de 2026 e "2026-08-30" como 30 de agosto de 2026, enquanto "12.50" e "000417" permaneceram texto.
Assim, uma importação que copia campos CSV como strings pode transformar um preço de 8.27 em um serial de data próximo a 46.261. O padrão seguro é importar com a conversão desativada, analisar cada coluna com a cultura invariável e atribuir valores int, decimal, double, ou DateTime.
Resultados da Fórmula no Arquivo Salvo
IronXL calcula fórmulas quando você as lê, então uma verificação que recarrega a planilha através do IronXL sempre vê uma resposta atual. O arquivo salvo é outra questão. Leitores que não calculam, como openpyxl e pandas, veem apenas os resultados que o arquivo armazena.
Em nossos testes, uma fórmula que nunca foi lida ou avaliada antes de SaveAs foi escrita sem resultado armazenado. Uma fórmula lida uma vez, seguida de uma alteração em sua entrada e um salvamento, manteve o resultado antigo no arquivo. IronXL relatou o novo total de 43 após o recarregamento, enquanto openpyxl leu os 5 armazenados. Após EvaluateAll e então SaveAs, cada fórmula carregava seu valor atual. O guia de edição de fórmulas chama EvaluateAll pelo mesmo motivo.
Referências cruzadas de planilhas funcionam como esperado. Um SUMIF em uma planilha Summary sobre intervalos da planilha Orders foi avaliado corretamente, salvo e recarregado como uma fórmula com seu valor.
Texto da Fórmula Retornado por IronXL
Uma verificação de que cada linha de Orders mantém sua fórmula Revenue pode comparar texto de fórmula, mas o IronXL não devolve a string que foi dada. Atribuímos =E2*F2 na célula G2 com 2026.10.1, e a propriedade Formula retornou E2*F2 sem o sinal de igual, tanto antes do salvamento quanto após um recarregamento. Esse é o conteúdo do elemento fórmula no XML da planilha. A própria documentação XML do IronXL para Cell.Formula fornece =A2+A2+A3+A4 como seu exemplo, e o guia de edição de fórmulas escreve fórmulas mas lê de volta apenas seus resultados.
Uma fórmula escrita sem o sinal de igual é lida de volta inalterada, e uma atribuída através de Value perde seu sinal de igual da mesma forma. Uma célula contendo um número simples retorna null. IronXL mantém o caso e o espaçamento que foi dado, assim =e5 * f5 é lido de volta como e5 * f5.
Assim, uma auto-verificação que compara texto de fórmula com =E2*F2 falha em um livro de trabalho correto. No prompt abaixo, uma falha falsa desse tipo enviaria o agente de volta ao passo 11 para alterar o código de relatório que já estava correto.
Colunas inteiras têm uma segunda armadilha. A propriedade Formula em um intervalo de várias células retorna null a menos que cada célula possua a mesma fórmula. O intervalo G2:G5 foi null para quatro fórmulas corretas por linha, a mesma resposta que deu para E2:E5, que não possui fórmula alguma. Teste IsFormula em cada Cell, e compare texto de fórmula apenas após remover o = da string esperada.
Limites de Saída XLS
Sistemas mais antigos de pedidos e contabilidade ainda exportam XLS, e IronXL lê e escreve esse formato. Escrevê-lo tem limites que o XLSX não tem.
| Operação | XLSX | XLS em 2026.10.1 |
|---|---|---|
| Linhas | 1.048.576, depois lança | 65.536, então ArgumentException |
| Gráficos | funciona | Exceção, mensagem recomenda XLSX |
Password, Encrypt, ou SaveAs com uma senha | criptografa | ArgumentException, apenas .xlsx, .xlsm, .xltx |
| Texto 000501 | texto | texto |
DateTime | data | data, IsDateTime verdadeiro após recarregamento |
Um arquivo XLS que IronXL escreve é uma planilha Excel 97-2003 genuína. Seus primeiros oito bytes são D0 CF 11 E0 A1 B1 1A E1, a assinatura do arquivo composto, que é uma maneira rápida de confirmar que um assistente não salvou conteúdo XLSX sob um nome .xls.
Proteção de Planilha e Criptografia de Arquivo
Peça por um "livro de trabalho protegido por senha" e um assistente pode escolher uma das duas funcionalidades do IronXL. Eles se comportam de maneira diferente.
| Salvo com | Primeiros bytes | Sem senha | Senha errada |
|---|---|---|---|
ProtectSheet com Q3-review em cada planilha | 50 4B 03 04 (ZIP) | abre | abre |
WorkBook.Password, SaveAs com uma senha, ou Encrypt, então SaveAs | D0 CF 11 E0 (criptografado) | ArgumentNullException | SecurityException, Senha inválida |
Todos os quatro abrem com a senha correta. ProtectSheet visa impedir edições dentro do Excel, e não criptografa nada. Quando o requisito é que terceiros não possam ler o arquivo, peça criptografia pelo nome, como o guia de senha de livro de trabalho faz. Encrypt também retorna o livro de trabalho criptografado como um fluxo e armazena a senha no livro de trabalho, que é por isso que o SaveAs que se segue escreve um arquivo criptografado. WorkBook.Load com uma senha abre o resultado.
Um Resultado Que Você Pode Reproduzir
O teste é um único prompt e nenhum código seu. Abra uma sessão nova em uma pasta vazia, cole o prompt e compare o que volta com a lista de aprovação abaixo dele.
IRONXL_LICENSE_KEY.O 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 o prompt com um programa de referência no IronXL 2026.10.1 e semente 2026. Importando através de LoadCSV com formato XLSX, delimitador de ponto e vírgula e conversão de campo ativada, e depois copiando os valores convertidos, coincidiram 9 de 16 linhas. Todos os 200 OrderIds CSV perderam seus zeros à esquerda, e as unidades de cada região ficaram aquém porque 48 quantidades após uma citação escapada foram mantidas como texto. Importar com a conversão desativada e copiar as strings coincidiu 8 de 16, porque os preços 8.27 e 10.11 viraram datas, o que empurrou a receita do Norte para 3,9 vezes seu valor real e a do Sul para 2,9 vezes. Analisando cada coluna explicitamente e escrevendo valores tipados coincidiu 16 de 16 nas sementes 2026, 77, 4101 e 12345. Um rascunho anterior deste prompt passou 9 de 9 no IronXL 2026.9.2 com nomes de produtos ASCII simples, IDs numéricos puros e totais antigos lidos pelo mesmo código que construiu o relatório, portanto, testou pouco.
Saída
Esta imagem é uma renderização da planilha Summary na execução do sales-report.xlsx, desenhada a partir dos valores e do gráfico que o arquivo salvo armazena, e não uma captura de tela tirada no Excel. A tabela de ida e volta sem edição da execução mantém cada medição do passo 5, o procedimento de importação e as 16 linhas.
- A primeira execução do programa parou no teste do passo 5, porque o Norte e o Sul tinham ambos 90 pedidos e suas receitas estavam 921,94 distantes. Claude Code ampliou as participações regionais, gerou os inputs novamente e coincidiu todas as 16 linhas na próxima execução, então o loop de reparo no passo 11 nunca foi executado.
- Neste
orders.csvda execução, um carregamento com conversão ativada não manteve nenhum dos 200 OrderIds como texto com zero à esquerda e deixou 38 quantidades como texto, então a importação óbvia teria falhado aqui também. - Antes de escrever o programa, Claude Code tentou a importação CSV do IronXL em uma pasta de rascunho e escolheu o procedimento seguro logo de cara. Ele carrega o XLS com
WorkBook.Loade dá a cada coluna uma regra que testa o próprio tipo da célula. - Os inputs mediram 200 pedidos CSV, com 43 produtos contendo ponto e vírgula, 38 uma citação escapada e 48 uma letra não ASCII, e 9 de 9 medições do passo 5 ficaram na faixa.
- Summary mantém 8 fórmulas SUMIF e 2 SUM com totais armazenados de 5.337 unidades e $549.169,80, além de um gráfico de colunas. A cópia criptografada abre com Q3-review para 250 pedidos.
- Alguns passos foram executados de forma diferente da página. Claude Code contou as linhas CSV do próprio arquivo, mas pegou as cifras que abrangem os dois arquivos dos registros do gerador, enquanto
roundtrip.mddiz que vieram dos arquivos de entrada. Ele carregou ambos os inputs através deLoadingOptions, que nenhuma páginallms.txtdocumenta links, e verificou a chave comenv | grep -c, que lista as variáveis de ambiente em uma contagem. Os prompts dos Passos 1, 3, 5 e 7 seguiram na mesma sessão. A instalação manteve a fixação 2026.10.1. O prompt da documentação encontrouPhysicalRowCountapenas na referência da API e substituiuLoadingOptionsporWorkBook.LoadCSVeWorkBook.Load, então o arquivo de ida e volta publicado descreve essa importação. Coincidiu 16 de 16 novamente. O prompt de configuração escreveu as regras paraCLAUDE.mde salvouskill.mdcomo uma habilidade de projeto. A auto-verificação nomeou uma página de documentação para cada membro, encontrou 69 de 69 células amostradas em acordo, e coincidiu todas as 250 linhas de cada planilha com o manifesto. Medimos novamente cada critério de aprovação nos arquivos salvos sem IronXL, e uma compilação Release fresca do programa produziu a mesma tabela.
O que passa
- O projeto compila em Release sem edições manuais.
- Todas as 16 linhas de
roundtrip.mdcoincidem, e suas figuras regionais e totais são iguais aos totais dos arquivos de entrada. - Uma busca na pasta do projeto não encontra a chave de licença em nenhum arquivo.
O registro da execução
- As execuções usam um desktop Windows 11 x64 com um Core i9-14900KF e 64 GB de memória.
- Cada projeto visa .NET 9.
- Cada guia utiliza
IronXL.Excel2026.10.1 como o único pacote IronXL, exceto o guia Claude Code, cuja execução instalou 2026.10.5. ChatGPT Codex adicionouMicrosoft.Extensions.DependencyInjection9.0.20 ao seu conversor, e os projetos de teste do Codex, Copilot, Cursor e Antigravity são executados no xUnit. - A duração de um guia é a soma dos tempos registrados dos prompts em sua página, e a linha deste guia conta apenas o prompt de aceitação.
- Último testado: 15 de outubro de 2026, com a execução deste guia. Google Antigravity foi testado em 14 de outubro. Claude Code e GitHub Copilot foram testados em 13 de outubro, Cursor em 9 de outubro e ChatGPT Codex em 7 de outubro de 2026.
| Guia | Assistente e versão | Modelo | Duração (minutos) |
|---|---|---|---|
| Este guia | Claude Code 2.1.277, uma sessão, prompts de permissão desativados | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, prompt 3 em modo de plano | Claude Sonnet 5, com Claude Opus 5 para o prompt 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, roviado pelo Auto | 14.5 |
| Cursor | Aplicativo desktop Cursor 3.23.23 | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 3.8 Flash (Alto) | 44.9 |
Guias Específicos para Agentes
Cada guia abaixo aplica os passos acima em uma ferramenta e em um trabalho de planilha.
- Use IronXL com Claude Code para ler planilhas de milhões de linhas com streaming apenas para frente, com memória e tempo medidos contra uma carga completa da planilha
- Use IronXL com ChatGPT Codex para converter uma pasta de arquivos mistos XLS, XLSX, CSV e TSV para CSV, JSON e XML, com uma linha de resultados para cada entrada e tratamento para arquivos corrompidos ou protegidos
- Use IronXL com GitHub Copilot para estilizar a saída de uma solução de relatório existente, com testes que recarregam cada planilha e confirmam seus formatos
- Use IronXL com Cursor para mover o código de edição de planilha do Office Interop, sob regras que mantêm chamadas de Interop e EPPlus de fora
- Use IronXL com Google Antigravity para uma página ASP.NET Core que visualiza, valida e limpa uma planilha carregada, comprovado por uploads em uma sessão de navegador ao vivo
Solução de problemas
- IronXL Limites de Tamanho de Arquivo quando uma planilha XLS fica sem linhas
- Aplique uma Chave de Licença no IronXL uma vez que a primeira chamada de planilha lança LicensingException
- FileNotFoundException para IronXL.XmlSerializers em .NET 10 quando um debugger interrompe dentro da chamada de salvamento, embora o arquivo seja escrito
Questões?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.