Verwendung von IronXL mit KI-Coding-Assistenten
IronXL ist eine .NET-Bibliothek von Iron Software zur Arbeit mit Excel-Dateien. Es erstellt, liest und bearbeitet XLSX- und ältere XLS-Arbeitsmappen, importiert CSV- und TSV-Dateien, wertet Formeln aus und zeichnet Diagramme, alles ohne installiertes Microsoft Office. IronXL ist seit 2019 auf NuGet verfügbar, und seine Tutorials verwenden WorkBook und WorkSheet durchgehend.
Die Klassennamen zeigen nicht, wie die Version 2026.10.1 Ihre Daten behandelt. Geben Sie IronXL die Zeichenkette '8.27' als Zellwert und es speichert den 27. August des aktuellen Jahres. Importieren Sie ein CSV mit aktivierter Feldkonvertierung und eine OrderId von 000417 wird als die Zahl 417 zurückgegeben. Speichern Sie ohne Aufruf von EvaluateAll und die Datei kann ein Formelergebnis vom vor der letzten Bearbeitung enthalten. Keine dieser Optionen stoppt einen Build.
Diese Seite richtet jeden Assistenten für diese Art von Arbeit ein.
- Chat-artige Assistenten schreiben den von Ihnen ausgewählten Code um oder antworten aus dem Editor.
- Agenten wie ChatGPT Codex, Google Antigravity, Claude Code und Cursor übernehmen eine ganze Aufgabe, erstellen dann den Code und führen ihn aus.
Die Einrichtung ist bei beiden gleich, egal ob die Aufgabe CSV-Export lesen, Formeln bearbeiten, ein Diagramm hinzufügen oder eine Arbeitsmappe verschlüsseln ist.
So verwenden Sie IronXL mit einem KI-Coding-Assistenten
- Holen Sie sich das IronXL.Excel-Paket von NuGet
- Weisen Sie
IronXL.License.LicenseKeyvonIronXL_LICENSE_KEYvor dem ersten Arbeitsmappenaufruf zu - Übergeben Sie dem Assistenten den Index
llms.txtvon IronXL zu Beginn der Sitzung - Bewahren Sie die IronXL-Regeln in der Anleitungsdatei auf, die Ihr Assistent lädt
- Öffnen Sie eine neue Sitzung und senden Sie den One-Shot-Einrichtungshinweis
- Erstellen und führen Sie das Programm aus und senden Sie dann den Selbst-Check-Hinweis
Kann mein KI-Assistent Excel nicht allein bewältigen?
Ein Assistent, der sich nur auf das Gedächtnis verlässt, schreibt das IronXL, das er im Training gesehen hat, was Mitglieder einschließen kann, die die aktuelle Version nicht hat. IronXL veröffentlicht seine Dokumentation in einer Form, die Werkzeuge lesen können, sodass der Assistent stattdessen von der aktuellen API ausgehen kann.
Eine Nummerngitter in XLSX zu schreiben ist der einfache Teil. Die Unterschiede zwischen Bibliotheken treten bei Formeln, alten XLS-Eingaben, CSV-Dateien von Anbietern und Arbeitsmappen auf, die für Außenstehende geschlossen bleiben müssen.
- Office Interop bindet Code an einen Desktop: Ein Assistent, der Interop einsetzt, benötigt Excel auf jedem Rechner, auf dem der Code ausgeführt wird, während das IronXL-Paket auf Windows-, Linux- und macOS-Servern läuft.
- Das Umschreiben des CSV-Parsers kostet Token: Ein Agent, der IronXLs CSV-Import durch einen handgeschriebenen Splitter aufgrund eines schlechten Imports ersetzt, zahlt jedes Mal und muss die neuen Parser-Regeln für Anführungszeichen lernen, die IronXL bereits verarbeitet.
- Der Paketname und der Namensraum unterscheiden sich: Die NuGet-ID ist
IronXL.Excelund der Namensraum istIronXL. Eine vermutete ID kann auf ein ähnliches Paket auflösen, das veröffentlicht wurde, um diese Vermutung zu fangen, den Angriff genannt slopsquatting. Schreiben Sie die genaue ID in die Eingabeaufforderung.
Schritt 1: Installieren Sie IronXL
Mit referenziertem Paket kann der Assistent die realen Typen von IronXL prüfen.
Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
Um stattdessen eine Version aus dem Terminal zu pinnen, nennen Sie sie.
dotnet add package IronXL.Excel --version 2026.10.5
IronXL.Excel 2026.10.5 hängt nur von IronSoftware.Common und IronSoftware.System.Drawing ab.
Schritt 2: Anwenden des Lizenzschlüssels
IronXL fällt nicht auf einen Wasserzeichen- oder eingeschränkten Modus zurück. Ohne einen Schlüssel löst das Erstellen, Laden oder Importieren einer Arbeitsmappe eine IronSoftware.Exceptions.LicensingException mit der Nachricht Production License Required aus. Bei einem falsch geschriebenen Schlüssel schlägt der erste Aufruf stattdessen mit License Key Not Recognized fehl. Ein kostenloser Testschlüssel befindet sich unten, und die Lizenzierungsseite gibt die Entwickler-, Standort- und Projektanzahl für jede unbefristete Lizenzstufe an.
Beginnen Sie noch heute, IronXL in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden.
Setzen Sie den Schlüssel einmal, wenn das Programm startet, vor jedem anderen IronXL-Aufruf, und holen Sie ihn aus der IRONXL_LICENSE_KEYUmgebungsvariable, um ihn aus der Versionskontrolle herauszuhalten.
IronXL.License.IsLicensed gibt true zurück, nachdem ein gültiger Schlüssel angewendet wurde, und IronXL.License.IsValidLicense gibt an, ob ein gegebener Schlüssel gültig und nicht abgelaufen ist. Der Ausnahmetyp ist intern, also kompiliert eine catch-Klausel, die ihn benennt, nicht und meldet CS0122. Überprüfen Sie IsLicensed beim Start, oder fangen Sie Exception und lesen Sie die Nachricht.
Web.config oder appsettings.json aufbewahrt.Schritt 3: Weisen Sie Ihren Assistenten auf die IronXL-LLM-Dokumentation hin
llms.txtist ein verknüpfter Index mit einer Zeile pro Seite und gehört an den Anfang jeder Sitzung.- Zusammenfassungen von 94 Seiten kommen in einer Datei in
llms-full.txtan, die für breite Fragen geeignet ist. llms-full-catalog.txtfügt jeden Blog-Post zum Index hinzu, für Vergleiche und Blog-Anleitungen.- Die API-Referenz listet jeden Namensraum, Typ und jedes Mitglied auf.
- Werkzeuge, die Skill-Dateien laden, können
skill.mdübernehmen, das Installationen, Lizenzierung, Rezepte und häufige Fehler abdeckt. - Das AI-Produktblatt liefert eine Seite Hintergrund.
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.
Wenn eine Aufgabe von einem Leitfaden abhängt, bitten Sie den Assistenten, diese Seite zu öffnen.
Schritt 4: Fügen Sie Ihrem Projekt den IronXL-Kontext hinzu
Chat-Anweisungen verschwinden, wenn der Chat geschlossen wird. Eine Projektdatei wird jedes Mal erneut gelesen, wenn eine Sitzung geöffnet wird, fügen Sie also die IronXL-Regeln zu der hinzu, die Ihr Team bereits pflegt. Claude Code liest CLAUDE.md, ChatGPT Codex liest AGENTS.md und GitHub Copilot liest .github/copilot-instructions.md. Cursor liest .mdc Dateien in .cursor/rules/ oder AGENTS.md. Google Antigravity liest AGENTS.md oder GEMINI.md. Die Regeln lesen sich in jeder Datei gleich.
## 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.
Die Skill-Datei erhält Verschlüsselung, Blattschutz und EvaluateAll richtig. Es warnt nicht vor den führenden Nullen oder der Datumskonvertierung, behalten Sie also diese zwei Zeilen in Ihrer eigenen Datei. Sein Beispiel für eine einzige Datei pinnt immer noch 2026.8.1, drei Versionen hinter dem 2026.10.5-Paket auf NuGet, also aktualisieren Sie den Pin auf die Version, die Ihr Projekt verwendet.
Schritt 5: Einmaliger Einrichtungsaufforderung
Die Schritte 1 bis 4 passen in eine Nachricht. Senden Sie sie, wenn ein Projekt startet oder in einer neuen Sitzung.
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.
Schritt 6: Aufforderungsmuster, die funktionierenden Code produzieren
Benennen Sie das Blatt, die Zellen und das Format. Der Assistent kann nicht erraten, welche Zellen wichtig sind oder welches Dateiformat die Aufgabe benötigt.
Vage Wandeln Sie unsere Aufträge in einen Excel-Bericht mit IronXL um.
Besser Erstellen Sie die Arbeitsmappe mit
WorkBook.Create(ExcelFileFormat.XLSX), schreiben Sie die Aufträge in ein Blatt namens Aufträge mit einer fettgedruckten, eingefrorenen Kopfzeile, wenden SieBuiltinFormats.Currency2auf die Spalte UnitPrice an und setzen Sie ein SUMIF pro Region auf ein Übersichtsblatt.
Geben Sie die Version und das Framework an. Das Verhalten ändert sich zwischen den Versionen, und ein Assistent ohne Version kann alte und neue mischen.
Besser Zielen Sie auf .NET 9 und IronXL.Excel 2026.10.5.
Fordern Sie ganze Dateien an. Ein Fragment verliert seine using Direktiven, was wichtig ist, da BuiltinFormats in IronXL.Formatting und ChartType in IronXL.Drawing.Charts lebt.
Besser Geben Sie die vollständige
Program.csmit jeder using-Direktive und der Lizenzzuweisung zurück, damit sie so kompilierbar ist, wie sie steht.
Schritt 7: Verifizieren Sie, was Sie zurückbekommen
Jeder dieser Fehler reproduziert sich in 2026.10.1.
- Ein mehrdeutiges
Range: Bei impliziten using-Deklarationen führt das Assignieren eines Zellbereichs wieA1:B2zu einerRangeVariable dazu, dass beideIronXL.RangeundSystem.Rangeübereinstimmen und mit CS0104 fehlschlägt. Schreiben SieIronXL.Range, oder fügen Sie ein Alias hinzu. - Zellenmitglieder auf einen Bereich aufgerufen: Indizieren einer einzelnen Zelle wie
A1gibt weiterhin einenIronXL.Rangezurück, daher schlägt der Aufruf vonAddCommentauf diesem Ergebnis mit CS1061 fehl. Rufen SieFirstauf, umCellzu erreichen. - Der falsche Leser für eine Semikolon-Datei:
WorkBook.Loadteilte eine Komma-Datei in Spalten auf, platzierte aber jede ganze Zeile einer Semikolon-Datei in Spalte A und löste FileLoadException bei einer Datei mit semikolon-abgegrenzten, zitierten Feldern aus. Übergeben Sie den Delimiter anWorkBook.LoadCSV, wie es der CSV-Leseleitfaden tut.
Lassen Sie den Agenten seine eigene Arbeit überprüfen
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.
CSV-Feld- und Zellwertkonvertierung
Die Typkonvertierung erfolgt an zwei Stellen. Diese Ergebnisse stammen von IronXL.Excel 2026.10.1 auf .NET 9.
WorkBook.LoadCSV nimmt ein convertFieldValues Flagge an, und sie ist standardmäßig true.
| Feld im CSV | Konvertierung ein | Konvertierung aus |
|---|---|---|
| 000417 (ID) | Nummer 417 | Text 000417 |
| 12.50 (Preis) | Nummer 12.5 | Text 12.50 |
| 2026-08-30 (Datum) | Text | Text |
| 2 nach "Monitor 27" matte | Text | Text |
| "Bolt; M8 Zink" | ein Feld | ein Feld |
Das Zitieren funktioniert wie in RFC 4180 beschrieben, und UTF-8-Namen wie Café mit Akzent haben den Import erhalten, mit oder ohne Byte Order Mark. Die Zeile mit einem escape-Zitat hielt ihre nächste Nummer als Text, und SUM und SUMIF überspringen Text, während eine Formel, die dieselben Zellen multiplizierte, weiterhin funktionierte.
Der zweite Ort ist der Value Setter. Ein als Zellwert zugewiesener String wird analysiert, und Strings in Form von Monat und Tag werden zu Daten. In unseren Tests wurde '1.5' als 5. Januar 2026 gespeichert und '2026-08-30' als 30. August 2026, während '12.50' und '000417' Text blieben.
Ein Import, der CSV-Felder als Strings kopiert, kann einen Preis von 8,27 in ein Datum mit einer Seriennummer nahe 46.261 verwandeln. Das sichere Muster ist, mit deaktivierter Konvertierung zu importieren, jede Spalte mit der invariant culture zu parsen und int, decimal, double oder DateTime Werte zuzuweisen.
Formelergebnisse in der gespeicherten Datei
IronXL berechnet Formeln, wenn Sie sie lesen, sodass eine Überprüfung, die die Arbeitsmappe durch IronXL neu lädt, immer eine aktuelle Antwort sieht. Die gespeicherte Datei ist eine andere Sache. Leser, die nicht berechnen, wie openpyxl und pandas, sehen nur die Ergebnisse, die die Datei speichert.
In unseren Tests wurde eine Formel, die nie gelesen oder ausgewertet wurde, bevor SaveAs geschrieben wurde, ohne gespeichertes Ergebnis gespeichert. Eine einmal gelesene Formel, gefolgt von einer Änderung ihres Eingabewerts und einem Speichern, behielt das alte Ergebnis in der Datei bei. IronXL meldete das neue Gesamtergebnis von 43 nach dem Neuladen, während openpyxl die gespeicherten 5 las. Nach EvaluateAll und dann SaveAs trug jede Formel ihren aktuellen Wert. Der Formelbearbeitungsleitfaden ruft EvaluateAll aus demselben Grund auf.
Querverweisungen zwischen Blättern funktionieren wie erwartet. Ein SUMIF auf einem Übersichtsblatt über Bereiche des Auftragsblatts wurde korrekt ausgewertet, gespeichert und als Formel mit seinem Wert wieder geladen.
Formeltext, den IronXL zurückgibt
Eine Überprüfung, dass jede Auftragszeile ihre Umsatzformel enthält, kann Formeltext vergleichen, aber IronXL gibt nicht die Zeichenkette zurück, die ihm gegeben wurde. Wir wiesen =E2*F2 auf Zelle G2 mit 2026.10.1 zu, und die Formula Eigenschaft gab E2*F2 ohne Gleichheitszeichen zurück, sowohl vor der Speicherung als auch nach einem Neuladen. Das ist der Inhalt des Formelelements im Blatt-XML. IronXLs eigene XML-Dokumentation zu Cell.Formula gibt =A2+A2+A3+A4 als Beispiel an, und der Formelbearbeitungsleitfaden schreibt Formeln, liest jedoch nur ihre Ergebnisse zurück.
Eine Formel, die ohne das Gleichheitszeichen geschrieben wurde, liest sich unverändert zurück, und eine durch Value zugewiesene Formel verliert ihr Gleichheitszeichen auf dieselbe Weise. Eine Zelle, die eine einfache Nummer hält, gibt null zurück. IronXL behält die ihm gegebene Großschreibung und den Abstand bei, daher liest sich =e5 * f5 als e5 * f5 zurück.
Eine Selbstüberprüfung, die Formeltext mit =E2*F2 vergleicht, schlägt bei einer korrekten Arbeitsmappe fehl. In dem Hinweis unten würde ein falsches Fehlschlagen dieser Art den Agenten zurück zu Schritt 11 schicken, um Berichtscode zu ändern, der bereits richtig war.
Ganze Spalten haben eine zweite Falle. Die Formula Eigenschaft auf einem Multi-Zellen-Bereich gibt null zurück, es sei denn, jede Zelle enthält dieselbe Formel. Der Bereich G2:G5 war null für vier korrekte Zeilenformeln, dieselbe Antwort, die er für E2:E5 gab, die überhaupt keine Formel hat. Testen Sie IsFormula auf jede Cell und vergleichen Sie den Formeltext nur, nachdem Sie = aus der erwarteten Zeichenkette entfernt haben.
XLS-Ausgabelimits
Ältere Bestell- und Buchhaltungssysteme exportieren immer noch XLS, und IronXL liest und schreibt es. Das Schreiben hat Begrenzungen, die XLSX nicht hat.
| Betrieb | XLSX | XLS in 2026.10.1 |
|---|---|---|
| Zeilen | 1.048.576, dann wirft | 65.536, dann ArgumentException |
| Diagramme | funktioniert | Ausnahme, Nachricht empfiehlt XLSX |
Password, Encrypt oder SaveAs mit einem Passwort | verschlüsselt | ArgumentException, nur .xlsx, .xlsm, .xltx |
| Text 000501 | Text | Text |
DateTime | Datum | Datum, IsDateTime wahr nach dem Neuladen |
Eine von IronXL geschriebene XLS-Datei ist eine echte Excel 97-2003-Arbeitsmappe. Ihre ersten acht Bytes sind D0 CF 11 E0 A1 B1 1A E1, die Compound-Datei-Signatur, was ein schneller Weg ist, zu bestätigen, dass ein Assistent keine XLSX-Inhalte unter einem .xls Namen gespeichert hat.
Blattschutz und Dateiverschlüsselung
Nach einem "passwortgeschützten Workbook" zu fragen, und ein Assistent kann eines von zwei IronXL-Funktionen auswählen. Sie verhalten sich unterschiedlich.
| Gespeichert mit | Erste Bytes | Kein Passwort | Falsches Passwort |
|---|---|---|---|
ProtectSheet mit Q3-Überprüfung auf jedem Blatt | 50 4B 03 04 (ZIP) | öffnet | öffnet |
WorkBook.Password, SaveAs mit einem Passwort oder Encrypt, dann SaveAs | D0 CF 11 E0 (verschlüsselt) | ArgumentNullException | SecurityException, Ungültiges Passwort |
Alle vier öffnen sich mit dem richtigen Passwort. ProtectSheet ist so konzipiert, dass Bearbeitungen in Excel unterbunden werden, und es verschlüsselt nichts. Wenn die Anforderung besteht, dass Außenstehende die Datei nicht lesen können, bitten Sie um Verschlüsselung mit Namen, wie es der Leitfaden zum Workbook-Passwort tut. Encrypt gibt auch das verschlüsselte Workbook als Stream zurück und speichert das Passwort auf dem Workbook, weshalb die SaveAs, die folgt, eine verschlüsselte Datei schreibt. WorkBook.Load mit einem Passwort öffnet das Ergebnis.
Ein Ergebnis, das Sie reproduzieren können
Der Test ist eine Eingabeaufforderung und kein Code von Ihnen. Öffnen Sie eine neue Sitzung in einem leeren Ordner, fügen Sie den Hinweis ein und vergleichen Sie, was zurückkommt, mit der Passliste darunter.
IRONXL_LICENSE_KEY.Die Aufforderung
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.
Wir haben die Eingabeaufforderung mit einem Referenzprogramm auf IronXL 2026.10.1 und Seed 2026 kalibriert. Beim Importieren über LoadCSV mit einem XLSX-Format, einem Semikolon-Trennzeichen und eingeschalteten Feldkonvertierung sprachen dann das Kopieren der konvertierten Werte 9 von 16 Zeilen. Alle 200 CSV-OrderIds verloren ihre führenden Nullen, und jede Regionseinheit kam zu kurz, weil 48 Mengen nach einem Escape-Zitat als Text blieben. Importieren ohne Konvertierung und Kopieren der Strings stimmte mit 8 von 16 überein, weil die Preise 8.27 und 10.11 zu Daten wurden, was das Umsatzniveau von North auf 3,9-faches seines tatsächlichen Wertes und das von South auf 2,9-faches drückte. Das Parsen jeder Spalte explizit und das Schreiben von typisierten Werten stimmte mit 16 von 16 auf Seeds 2026, 77, 4101 und 12345. Ein früherer Entwurf dieses Hinweises bestand 9 von 9 auf IronXL 2026.9.2 mit einfachen ASCII-Produktnamen, nur numerischen IDs und alten Gesamtsummen, die durch denselben Code gelesen wurden, der den Bericht erstellte, weshalb es wenig testete.
Ausgabe
Dieses Bild ist eine Wiedergabe des Übersichtsblatts im Lauf des sales-report.xlsx, gezeichnet aus den Werten und dem Diagramm, das die gespeicherte Datei speichert, und kein Screenshot, der in Excel aufgenommen wurde. Die ungeänderte Round-Trip-Tabelle des Laufs enthält jede Schritt-5-Messung, das Importverfahren und die 16 Zeilen.
- Der erste Programmlauf stoppte beim Schritt-5-Check, weil Nord und Süd beide 90 Aufträge hatten und ihre Umsätze um 921,94 auseinander lagen. Claude Code erweiterte die Regionsteilungen, generierte die Eingaben erneut und passte alle 16 Zeilen beim nächsten Lauf an, daher lief die Reparaturschleife in Schritt 11 nie.
- Bei diesem Run ist
orders.csv, ein Laden mit eingeschalteter Konvertierung, behielt keine der 200 OrderIds als Text mit führenden Nullen und ließ 38 Mengen als Text, sodass der offensichtliche Import auch hier fehlgeschlagen wäre. - Bevor es das Programm schrieb, versuchte Claude Code IronXLs CSV-Import in einem Testordner und entschied sich für das sichere Verfahren im Voraus. Es lädt das XLS mit
WorkBook.Loadund gibt jedem Spaltenregel, die den Typ der Zelle selbst testet. - Die Eingaben maßen 200 CSV-Aufträge mit 43 Produkten mit Semikolon, 38 mit einem Escape-Zitat, und 48 mit einem nicht-ASCII-Buchstaben, und alle 9 der 9 Schritt-5-Messungen lagen im Bereich.
- Summary enthält 8 SUMIF- und 2 SUM-Formeln mit gespeicherten Gesamtsummen von 5.337 Einheiten und $549.169,80, plus einem Spaltendiagramm. Die verschlüsselte Kopie öffnet mit Q3-Überprüfung auf 250 Aufträge.
- Einige Schritte liefen anders als die Seite. Claude Code zählte die CSV-Zeilen aus der Datei selbst, nahm aber die Zahlen, die beide Dateien überspannen, aus den Aufzeichnungen des Generators, während
roundtrip.mdsagte, sie kämen aus den Eingabedateien. Es lud beide Eingaben überLoadingOptions, die keine Seite dokumentiert, diellms.txt-Links, und es überprüfte den Schlüssel mitenv | grep -c, das die Umgebungsvariablen in Zählungen auflistet. Die Schritt-1-, 3-, 5- und 7-Hinweise folgten in derselben Sitzung. Die Installation behielt den 2026.10.1-Pin. Der Dokumentationshinweis fandPhysicalRowCountnur in der API-Referenz und ersetzteLoadingOptionsmitWorkBook.LoadCSVundWorkBook.Load, daher beschreibt die veröffentlichte Round-Trip-Datei diesen Import. Es stimmte erneut mit 16 von 16 überein. Der Einrichtungs-Hinweis schrieb die Regeln inCLAUDE.mdund speicherteskill.mdals Projekt-Skill. Die Selbstüberprüfung nannte für jedes Mitglied eine Dokumentationsseite, fand 69 von 69 beprobte Zellen in Übereinstimmung und stimmte alle 250 Zeilen jeder Arbeitsmappe mit dem Manifest ab. Wir maßen jedes Passkriterium erneut bei den gespeicherten Dateien, ohne IronXL, und ein frischer Release-Build des Programms erzeugte dieselbe Tabelle.
Was besteht
- Das Projekt baut in Release ohne manuelle Bearbeitungen.
- Alle 16 Zeilen von
roundtrip.mdstimmen überein, und seine regionalen und Gesamtsummen entsprechen den Gesamtsummen der Eingabedateien. - Eine Suche im Projektordner findet den Lizenzschlüssel in keiner Datei.
Der Laufaufzeichnung
- Die Läufe verwenden einen Windows 11 x64 Desktop mit einem Core i9-14900KF und 64 GB Speicher.
- Jedes Projekt zielt auf .NET 9.
- Jeder Leitfaden verwendet
IronXL.Excel2026.10.1 als sein einziges IronXL-Paket, außer dem Claude Code Leitfaden, dessen Lauf 2026.10.5 installierte. ChatGPT Codex fügteMicrosoft.Extensions.DependencyInjection9.0.20 zu seinem Konverter hinzu, und die Testprojekte Codex, Copilot, Cursor und Antigravity laufen auf xUnit. - Die Dauer eines Leitfadens ist die Summe der protokollierten Zeiten der Hinweise auf seiner Seite, und diese Zeile des Leitfadens zählt den Akzeptanz-Hinweis allein.
- Zuletzt getestet: 15. Oktober 2026, mit dem Lauf dieses Leitfadens. Google Antigravity wurde am 14. Oktober getestet. Claude Code und GitHub Copilot wurden am 13. Oktober getestet, Cursor am 9. Oktober und ChatGPT Codex am 7. Oktober 2026.
| Anleitung | Assistent und Version | Modell | Dauer (Minuten) |
|---|---|---|---|
| Dieser Leitfaden | Claude Code 2.1.277, eine Sitzung, Erlaubnishinweise aus | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, Hinweis 3 im Planmodus | Claude Sonnet 5, mit Claude Opus 5 für Hinweis 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, von Auto geleitet | 14.5 |
| Cursor | Cursor 3.23.23 Desktop-Anwendung | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 3.8 Flash (Hoch) | 44.9 |
Agentenspezifische Anleitungen
Jeder der untenstehenden Leitfäden wendet die oben genannten Schritte auf ein Werkzeug und eine Tabellenkalkulationsaufgabe an.
- Verwenden Sie IronXL mit Claude Code zum Lesen von Millionen-Zeilen-Arbeitsmappen mit Vorwärts-Streaming, wobei Speicher und Zeit gegen eine vollständige Arbeitsmappenladung gemessen werden
- Verwenden Sie IronXL mit ChatGPT Codex zum Konvertieren eines Ordners mit gemischten XLS, XLSX, CSV und TSV-Dateien in CSV, JSON und XML, mit einer Ergebniszeile für jede Eingabe und Handhabung für beschädigte oder geschützte Dateien
- Verwenden Sie IronXL mit GitHub Copilot zum Stylen der Ausgabe einer bestehenden Berichtslösung, mit Tests, die jede Arbeitsmappe erneut laden und ihre Formate überprüfen
- Verwenden Sie IronXL mit Cursor zum Verschieben von Arbeitsmappenbearbeitungscode weg von Office Interop, unter Regeln, die Interop- und EPPlus-Aufrufe ausschließen
- Verwenden Sie IronXL mit Google Antigravity für eine ASP.NET Core-Seite, die eine hochgeladene Arbeitsmappe voransieht, validiert und säubert, bewiesen durch Uploads in einer Live-Browser-Sitzung
Fehlerbehebung
- IronXL-Dateigrößenbeschränkungen wenn eine XLS-Arbeitsmappe keine Zeilen mehr hat
- Einen Lizenzschlüssel in IronXL anwenden wenn der erste Arbeitsmappenaufruf LicensingException auslöst
- FileNotFoundException für IronXL.XmlSerializers auf .NET 10 wenn ein Debugger beim Speichern bricht, obwohl die Datei geschrieben wird
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.