Verwendung von IronXL mit KI-Coding-Assistenten

Curtis Chau
Curtis Chau
Aktualisiert: 18. Oktober 2026

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.

Claude Code AI-Kodierungs-Assistenten-LogoChatGPT Codex AI-Kodierungs-Assistenten-LogoGitHub Copilot KI-Coding-Assistenten-LogoCursor KI-Code-Editor-LogoGoogle Antigravity KI-Coding-Agenten-Logo

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.Excel und der Namensraum ist IronXL. 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.
Text

Um stattdessen eine Version aus dem Terminal zu pinnen, nennen Sie sie.

dotnet add package IronXL.Excel --version 2026.10.5
SHELL

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.

Erster Schritt:
arrow pointer

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.

Bitte beachten Sie: Anwenden von Lizenzschlüsseln zeigt, wie man den Schlüssel stattdessen in Web.config oder appsettings.json aufbewahrt.

Schritt 3: Weisen Sie Ihren Assistenten auf die IronXL-LLM-Dokumentation hin

  • llms.txt ist 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.txt an, die für breite Fragen geeignet ist.
  • llms-full-catalog.txt fü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.
Text

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.
Markdown

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.
Text
Tipps: Nach einem Sendevorgang öffnen Sie die Projektdatei aus Schritt 4 und prüfen Sie, ob die Regeln eingefügt wurden.

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 Sie BuiltinFormats.Currency2 auf 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.cs mit 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 wie A1:B2 zu einer Range Variable dazu, dass beide IronXL.Range und System.Range übereinstimmen und mit CS0104 fehlschlägt. Schreiben Sie IronXL.Range, oder fügen Sie ein Alias hinzu.
  • Zellenmitglieder auf einen Bereich aufgerufen: Indizieren einer einzelnen Zelle wie A1 gibt weiterhin einen IronXL.Range zurück, daher schlägt der Aufruf von AddComment auf diesem Ergebnis mit CS1061 fehl. Rufen Sie First auf, um Cell zu erreichen.
  • Der falsche Leser für eine Semikolon-Datei: WorkBook.Load teilte 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 an WorkBook.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.
Text

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 CSVKonvertierung einKonvertierung aus
000417 (ID)Nummer 417Text 000417
12.50 (Preis)Nummer 12.5Text 12.50
2026-08-30 (Datum)TextText
2 nach "Monitor 27" matteTextText
"Bolt; M8 Zink"ein Feldein 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.

BetriebXLSXXLS in 2026.10.1
Zeilen1.048.576, dann wirft65.536, dann ArgumentException
DiagrammefunktioniertAusnahme, Nachricht empfiehlt XLSX
Password, Encrypt oder SaveAs mit einem PasswortverschlüsseltArgumentException, nur .xlsx, .xlsm, .xltx
Text 000501TextText
DateTimeDatumDatum, 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 mitErste BytesKein PasswortFalsches Passwort
ProtectSheet mit Q3-Überprüfung auf jedem Blatt50 4B 03 04 (ZIP)öffnetöffnet
WorkBook.Password, SaveAs mit einem Passwort oder Encrypt, dann SaveAsD0 CF 11 E0 (verschlüsselt)ArgumentNullExceptionSecurityException, 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.

Bitte beachten Sie: Sie benötigen das .NET 9 SDK, eine Netzwerkverbindung, einen Assistenten mit der Berechtigung, Terminalbefehle auszuführen, und einen IronXL-Test- oder Produktschlüssel in 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.
Text

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

Summary sheet of the sales report from the acceptance run, with SUMIF units and revenue per region, a total row, and a column chart of revenue by region

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.Load und 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.md sagte, sie kämen aus den Eingabedateien. Es lud beide Eingaben über LoadingOptions, die keine Seite dokumentiert, die llms.txt-Links, und es überprüfte den Schlüssel mit env | 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 fand PhysicalRowCount nur in der API-Referenz und ersetzte LoadingOptions mit WorkBook.LoadCSV und WorkBook.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 in CLAUDE.md und speicherte skill.md als 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.md stimmen überein, und seine regionalen und Gesamtsummen entsprechen den Gesamtsummen der Eingabedateien.
  • Eine Suche im Projektordner findet den Lizenzschlüssel in keiner Datei.
Bitte beachten Sie: Um eine andere Version auszuprobieren, bearbeiten Sie die Version in Schritt 1 und lesen Sie das IronXL-Changelog, um herauszufinden, was sich geändert hat.

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.Excel 2026.10.1 als sein einziges IronXL-Paket, außer dem Claude Code Leitfaden, dessen Lauf 2026.10.5 installierte. ChatGPT Codex fügte Microsoft.Extensions.DependencyInjection 9.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.
AnleitungAssistent und VersionModellDauer (Minuten)
Dieser LeitfadenClaude Code 2.1.277, eine Sitzung, Erlaubnishinweise ausClaude Opus 516.4
Claude CodeClaude Code 2.1.277, Hinweis 3 im PlanmodusClaude Sonnet 5, mit Claude Opus 5 für Hinweis 353.8
ChatGPT CodexCodex CLI 0.160.0GPT-6 Luna59.0
GitHub CopilotGitHub Copilot CLI 1.0.97GPT-6 Luna, von Auto geleitet14.5
CursorCursor 3.23.23 Desktop-AnwendungGrok 4.753.1
Google AntigravityAntigravity CLI 1.3.5Gemini 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


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.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 2,393,101Version:2026.11gerade veröffentlicht