Korzystanie z IronXL z Asystentami Kodowania AI
IronXL to biblioteka .NET od Iron Software do pracy z plikami Excel. Tworzy, odczytuje i edytuje skoroszyty w formatach XLSX i starszych XLS, importuje pliki CSV i TSV, ocenia formuły i rysuje wykresy, wszystko bez zainstalowanego Microsoft Office. IronXL jest dostępny na NuGet od 2019 roku, a jego samouczki korzystają z WorkBook i WorkSheet w całym dokumencie.
Nazwy klas nie pokazują, jak wydanie 2026.10.1 traktuje dane. Podać IronXL ciąg znaków "8.27" jako wartość komórki, a zapisuje ona 27 sierpnia bieżącego roku. Importować CSV z włączoną konwersją pól, a OrderId 000417 zostaje zwrócone jako liczba 417. Zapisać bez wywoływania EvaluateAll, a plik może przechowywać wynik formuły sprzed ostatniej edycji. Żadna z tych rzeczy nie zatrzymuje budowania.
Ta strona przygotowuje dowolnego asystenta do takiej pracy.
- Asystenci w stylu czatowym przepisują wybrany kod lub odpowiadają z edytora.
- Agenci tacy jak ChatGPT Codex, Google Antigravity, Claude Code i Cursor biorą całe zadanie, a następnie budują i uruchamiają napisany przez siebie kod.
Konfiguracja jest taka sama dla obu, niezależnie od tego, czy zadanie polega na odczycie eksportu CSV, edycji formuł, dodaniu wykresu czy też szyfrowaniu skoroszytu.
Jak używać IronXL z Asystentem Kodowania AI
- Pobierz pakiet IronXL.Excel z NuGet
- Przypisz
IronXL.License.LicenseKeyzIronXL_LICENSE_KEYprzed pierwszym wywołaniem skoroszytu - Przekazać asystentowi indeks
llms.txtIronXL na początku sesji - Przechowuj zasady IronXL w pliku instrukcji ładowanym przez asystenta
- Otworzyć nową sesję i wysłać jedno-czolowy komunikat konfiguracyjny
- Zbudować i uruchomić program, a następnie wysłać test samooceny komunikat
Czy mój Asystent AI nie może sam obsługiwać Excela?
Pamieci asystenta zapisze IronXL z treningu, co może zawierać członków, których obecne wydanie nie posiada. IronXL publikuje swoją dokumentację w formie czytelnej dla narzędzi, aby asystent mógł pracować z aktualnym API.
Zapisanie siatki liczb w XLSX to najłatwiejsza część. Różnice między bibliotekami pojawiają się w formułach, starszych wejściach XLS, plikach CSV dostawcy i skoroszytach, które muszą być niedostępne dla osób z zewnątrz.
- Office Interop wiąże kod z jednym komputerem: Asystent, który sięga po Interop, potrzebuje zainstalowanego Excela tam, gdzie działa kod, podczas gdy pakiet IronXL działa na Windows, Linuksie i serwerach macOS.
- Przepisanie parsera CSV kosztuje tokeny: Agent, który zastępuje import CSV IronXL-a ręcznie napisanym dzielnikiem po jednym złym imporcie, płaci za każdą próbę, a nowy parser wciąż musi nauczyć się zasad cudzysłowów, które IronXL już obsługuje.
- Nazwa pakietu i przestrzeń nazw różnią się: ID NuGet to
IronXL.Excel, a przestrzeń nazw toIronXL. Odgadnięte ID może prowadzić do pakietu podobnego opublikowanego, aby przechwycić to odgadnięcie, ataku nazywanego slopsquatting. Zapisz dokładne ID w monicie.
Krok 1: Zainstalować IronXL
Z wymienionym pakietem asystent może sprawdzać rzeczywiste typy IronXL-a.
Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
Aby przypiąć wydanie z terminala zamiast tego, nazwij je.
dotnet add package IronXL.Excel --version 2026.10.5
IronXL.Excel 2026.10.5 zależy tylko od IronSoftware.Common i IronSoftware.System.Drawing.
Krok 2: Zastosować klucz licencyjny
IronXL nie przechodzi do trybu ograniczonego lub znakowanego wodnym znakiem. Bez klucza tworzenie, ładowanie lub importowanie skoroszytu wyrzuca IronSoftware.Exceptions.LicensingException z wiadomością Production License Required. Z błędnie wpisanym kluczem, pierwsze wywołanie nie udaje się z License Key Not Recognized zamiast tego. Poniżej znajduje się darmowy klucz próbny, a strona licencyjna podaje liczbę deweloperów, lokalizacje i liczbę projektów dla każdej wieczystej licencji.
Rozpocznij korzystanie z IronXL we własnym projekcie już dziś z darmową wersją próbną.
Ustawić klucz raz na początku działania programu, przed jakimkolwiek innym wywołaniem IronXL-a, i pobrać go ze zmiennej środowiskowej IRONXL_LICENSE_KEY, co pozwala na trzymanie go poza kontrolą źródła.
IronXL.License.IsLicensed zwraca wartość true po zastosowaniu ważnego klucza, a IronXL.License.IsValidLicense raportuje, czy dany klucz jest ważny i nieprzestarzały. Typ wyjątku jest wewnętrzny, więc sekcja catch, która go nazwie, nie kompiluje się i zgłasza CS0122. Sprawdź IsLicensed na starcie, czy złap Exception i przeczytaj wiadomość.
Web.config lub appsettings.json.Krok 3: Skierować Asystenta do Dokumentacji LLM IronXL-a
llms.txtto powiązany indeks z jedną linią na stronę, i należy go umieścić na początku każdej sesji.- Streszczenia 94 stron pojawiają się w jednym pliku w
llms-full.txt, co pasuje do szerokich pytań. llms-full-catalog.txtdodaje każdy wpis bloga do indeksu, do porównań i przejść przez blog.- Dokumentacja API wymienia każdą przestrzeń nazw, typ i członka.
- Narzędzia ładujące pliki umiejętności mogą przyjąć
skill.md, co obejmuje instalację, licencjonowanie, przepisy oraz częste błędy. - Karta Produktu AI daje jedną stronę tła.
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.
Kiedy zadanie zależy od jednego przewodnika, poproś asystenta o otwarcie tej strony.
Krok 4: Dodać kontekst IronXL-a do projektu
Instrukcje czatu znikają, gdy czat się zamyka. Plik projektu jest czytany ponownie, gdy otwierana jest sesja, więc dodaj zasady IronXL-a do tego, który twój zespół już utrzymuje. Claude Code czyta CLAUDE.md, ChatGPT Codex czyta AGENTS.md, a GitHub Copilot czyta .github/copilot-instructions.md. Cursor czyta pliki .mdc w .cursor/rules/, lub AGENTS.md. Google Antigravity czyta AGENTS.md lub GEMINI.md. Zasady są takie same w każdym pliku.
## 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.
Plik umiejętności poprawnie realizuje szyfrowanie, ochronę arkuszy i EvaluateAll. Nie ostrzega o wiodących zerach czy konwersji dat, więc zachować te dwie linie w pliku. Jego przykład jednoplikowy wciąż przypina 2026.8.1, trzy wydania za pakietem 2026.10.5 na NuGet, więc zaktualizować przypięcie do wydania, którego używa projekt.
Krok 5: Jednorazowy monit konfiguracji
Kroki od 1 do 4 mieszczą się w jednej wiadomości. Wyślij ją, gdy projekt się zaczyna lub w dowolnej nowej sesji.
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.
Krok 6: Wzorce monitów, które produkują działający kod
Nazwać arkusz, komórki i format. Asystent nie może zgadywać, które komórki mają znaczenie lub jaki format pliku zadanie wymaga.
Niejasne Zamień nasze zamówienia w raport Excel za pomocą IronXL.
Lepiej Utwórz skoroszyt za pomocą
WorkBook.Create(ExcelFileFormat.XLSX), zapisz zamówienia na arkuszu nazwanym Zamówienia z pogrubionym, zamrożonym wierszem nagłówka, zastosujBuiltinFormats.Currency2do kolumny UnitPrice i umieść SUMIF na arkuszu Podsumowanie dla każdego regionu.
Podać wydanie i framework. Zmiany zachowań między wersjami, a asystent bez wersji może mieszać stare i nowe.
Lepiej Celuj w .NET 9 i IronXL.Excel 2026.10.5.
Pytać o całe pliki. Fragment traci swoje using dyrektywy, co ma znaczenie, ponieważ BuiltinFormats żyje w IronXL.Formatting, a ChartType w IronXL.Drawing.Charts.
Lepiej Zwróć cały
Program.csz każdą dyrektywą using oraz przypisaniem licencji, aby skompilować go bez zmian.
Krok 7: Zweryfikuj, co otrzymujesz z powrotem
Każdy z tych błędów powtarza się na 2026.10.1.
- Dwuznaczny
Range: Z implicit usings, przypisanie zakresu arkusza jakA1:B2do zmiennejRangepasuje zarówno doIronXL.Range, jak iSystem.Range, i kończy się niepowodzeniem z CS0104. NapiszIronXL.Rangelub dodaj alias. - Członkowie komórki wywołani na zakres: Indeksowanie pojedynczej komórki, takiej jak
A1, wciąż zwracaIronXL.Range, więc wywołanieAddCommentna tym wyniku kończy się niepowodzeniem z CS1061. WywołajFirst, aby dotrzeć doCell. - Zły czytnik dla pliku z średnikiem:
WorkBook.Loaddzielił plik danych rozdzielany przecinkiem na kolumny, ale umieszczał każdą całą linię pliku z średnikiem w kolumnie A i wyrzucał FileLoadException dla pliku z średnikiem z polami cudzysłowami. Przekaż delimiter doWorkBook.LoadCSV, jak to robi przewodnik czytania CSV.
Pozwolić agentowi weryfikować swoją własną pracę
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.
Konwersja pól CSV i wartości komórek
Konwersja typów występuje na dwóch poziomach. Te wyniki są z IronXL.Excel 2026.10.1 na .NET 9.
WorkBook.LoadCSV przyjmuje flagę convertFieldValues i domyśla się do true.
| Pole w CSV | Konwersja włączona | Konwersja wyłączona |
|---|---|---|
| 000417 (ID) | liczba 417 | tekst 000417 |
| 12,50 (cena) | liczba 12,5 | tekst 12,50 |
| 2026-08-30 (data) | tekst | tekst |
| 2 po "Monitor 27" matowy | tekst | tekst |
| "Bolt; M8 cynk" | jedno pole | jedno pole |
Cytowanie działa zgodnie z opisem w RFC 4180, a nazwy w UTF-8, takie jak Cafe z akcentem, przetrwają import z lub bez znaku kolejności bajtów. Wiersz z ucieczkowym cytatem zachował swoją następną liczbę jako tekst, a SUM i SUMIF pomijają tekst, podczas gdy formuła, która mnożyła te same komórki, nadal działała.
Drugie miejsce to ustawienie Value. Łańcuch przypisany jako wartość komórki jest analizowany, a łańcuchy w kształcie miesiąca i dnia stają się datami. W naszych testach "1.5" było zapisane jako 5 stycznia 2026 roku, a "2026-08-30" jako 30 sierpnia 2026 roku, podczas gdy "12.50" i "000417" pozostały tekstem.
Więc import, który kopiuje pola CSV jako łańcuchy, może zamienić cenę 8.27 w blisko 46 261 numer daty seryjnej. Bezpieczny wzorzec to import z wyłączoną konwersją, analiza każdej kolumny z kulturą niezmienną i przypisanie wartości int, decimal, double, lub DateTime.
Wyniki formuły w zapisanym pliku
IronXL przelicza formuły, gdy są odczytywane, więc kontrola, która ponownie ładuje skoroszyt przez IronXL, zawsze widzi aktualną odpowiedź. Zapisany plik to inna sprawa. Czytnicy, którzy nie przeliczają, tacy jak openpyxl i pandas, widzą tylko wyniki, które plik przechowuje.
W naszych testach formuła, która nigdy nie była odczytana lub oceniona przed SaveAs, została zapisana bez przechowywanego wyniku. Formuła przeczytana raz, po której nastąpiła zmiana jej wejścia i zapisanie, zachowała stary wynik w pliku. IronXL zgłosił nową sumę 43 po ponownym załadowaniu, podczas gdy openpyxl odczytał przechowywane 5. Po EvaluateAll i potem SaveAs, każda formuła miała swoją aktualną wartość. Przewodnik edytowania formuły wywołuje EvaluateAll z tego samego powodu.
Referencje między kartami działają zgodnie z oczekiwaniami. SUMIF na arkuszu Podsumowanie nad zakresami arkusza Zamówienia oceniana poprawnie, zapisana i ponownie załadowana jako formuła z jej wartością.
Tekst formuły zwrócony przez IronXL
Kontrola, która porównuje tekst formuły dla każdego wiersza Zamówień, może porównywać tekst formuły, ale IronXL nie zwraca łańcucha, który został mu podany. Przypisano =E2*F2 w komórce G2 z 2026.10.1, a właściwość Formula zwróciła E2*F2 bez znaku równości, zarówno przed zapisaniem, jak i po ponownym załadowaniu. To jest zawartość elementu formuły w XML arkusza. Własna dokumentacja XML IronXL dla Cell.Formula podaje =A2+A2+A3+A4 jako swój przykład, a przewodnik edytowania formuł zapisuje formuły, ale odczytuje tylko ich wyniki.
Formuła zapisana bez znaku równości odczytuje się bez zmian, a formuła przypisana przez Value traci znak równości w ten sam sposób. Komórka trzymająca zwykłą liczbę zwraca null. IronXL zachowuje podaną jednostkę i odstępy, więc =e5 * f5 odczytuje się jako e5 * f5.
Więc samoocena, która porównuje tekst formuły z =E2*F2, zawodzi na poprawnym skoroszycie. W poniższym monicie fałszywe niepowodzenie tego rodzaju wysłałoby agenta z powrotem do kroku 11, by zmienić poprawny kod raportu.
Całe kolumny mają drugą pułapkę. Właściwość Formula na zakresie wielokomórkowym zwraca null, chyba że każda komórka ma tę samą formułę. Zakres G2:G5 był null dla czterech poprawnych formuł wiersz po wierszu, ta sama odpowiedź, którą dał dla E2:E5, która w ogóle nie trzyma żadnej formuły. Przetestuj IsFormula na każdej Cell i porównuj tekst formuły dopiero po usunięciu = z oczekiwanego łańcucha.
Limity wyjścia XLS
Starsze systemy zamówień i księgowo, wciąż eksportują do XLS, a IronXL odczytuje i zapisuje je. Zapisanie ma ograniczenia, których nie ma XLSX.
| Działanie | XLSX | XLS w 2026.10.1 |
|---|---|---|
| Wiersze | 1 048 576, a potem wyrzuca | 65 536, a potem ArgumentException |
| Wykresy | działa | Wyjątek, wiadomość zaleca XLSX |
Password, Encrypt, lub SaveAs z hasłem | szyfruje | ArgumentException, tylko .xlsx, .xlsm, .xltx |
| Tekst 000501 | tekst | tekst |
DateTime | data | data, IsDateTime true po ponownym załadowaniu |
Plik XLS zapisany przez IronXL jest prawdziwym skoroszytem Excel 97-2003. Jego pierwsze osiem bajtów to D0 CF 11 E0 A1 B1 1A E1, podpis pliku składowego, co jest szybkim sposobem na potwierdzenie, że asystent nie zapisał treści XLSX pod nazwą .xls.
Ochrona arkuszy i szyfrowanie plików
Należy poprosić o "skoroszyt z hasłem", a asystent może wybrać jedną z dwóch funkcji IronXL. Zachowują się one inaczej.
| Zapisane z | Pierwsze bajty | brak hasła | błędne hasło |
|---|---|---|---|
ProtectSheet z Q3-review na każdym arkuszu | 50 4B 03 04 (ZIP) | otwiera się | otwiera się |
WorkBook.Password, SaveAs z hasłem, lub Encrypt, potem SaveAs | D0 CF 11 E0 (szyfrowane) | ArgumentNullException | SecurityException, Nieprawidłowe hasło |
Wszystkie cztery otwierają się prawidłowym hasłem. ProtectSheet ma zatrzymać edycje wewnątrz Excela i nic nie szyfruje. Jeśli wymaganie jest takie, że osoby z zewnątrz nie mogą odczytać pliku, należy poprosić o szyfrowanie z nazwy, jak to robi przewodnik z hasłem do skoroszytu. Encrypt również zwraca zaszyfrowany skoroszyt jako strumień i przechowuje hasło na skoroszycie, dlatego zaraz po tym SaveAs zapisuje zaszyfrowany plik. WorkBook.Load z hasłem otwiera wynik.
Wynik, który można powtórzyć
Test to jeden monit i żadnych kodów użytkownika. Otworzyć świeżą sesję w pustym folderze, wkleić monit, i porównać to, co wraca, z listą pass pod spodem.
IRONXL_LICENSE_KEY.Monit
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.
Kalibrujemy monit z programem referencyjnym na IronXL 2026.10.1 i seed 2026. Importując przez LoadCSV z formatem XLSX, średnikiem jako delimiterem i włączoną konwersją pól, a następnie kopiowując wartości po konwersji, pasowało 9 z 16 wierszy. Wszystkie 200 IC OrderIds straciło swoje wiodące zera, a jednostki każdego regionu były niedobory, ponieważ 48 ilości po uciekłam cytacie pozostało tekstem. Importując z wyłączoną konwersją i kopiowując łańcuchy pasowało 8 z 16, ponieważ ceny 8.27 i 10.11 stały się datami, co podniosło przychód Północy do 3,9 razy swojej rzeczywistej wartości, a Południa do 2,9 razy. Analizując każdą kolumnę osobno i zapisując wartości typowe, pasowało 16 z 16 na seedach 2026, 77, 4101 i 12345. Wcześniejszy szkic tego monitu przeszedł 9 z 9 na IronXL 2026.9.2 z nazwami produktów plain ASCII, gołymi typowymi ID i starszymi sumami czytenymi przez ten sam kod, który zbudował raport, więc testowało niewiele.
Wynik
Ten obraz to rendering arkusza Podsumowanie w sales-report.xlsx działania, wykonany z wartości i wykresu, który przechowywał zapisany plik, a nie zrzut ekranu wykonany w Excelu. Niezmieniona tabela okrążeń działania zawiera każdy pomiar kroku 5, procedurę importu i 16 wierszy.
- Pierwsze wykonanie programu zatrzymało się na kontroli kroku 5, ponieważ Północ i Południe miały po 90 zamówienia, a ich przychody były różne o 921,94. Claude Code rozszerzył udziały regionów, ponownie wygenerował wejścia, i dopasował wszystkie 16 wierszy przy następnym wykonaniu, więc pętla naprawy w kroku 11 nigdy się nie uruchomiła.
- Na tej
orders.csvdziałania, załatwiając z włączoną konwersją, nie zostawiało żadnego z 200 OrderIds jako tekst z wiodącym zerem i zostawiało 38 ilości jako tekst, więc oczywisty import również by tu zawiódł. - Zanim napisał program, Claude Code wypróbował import CSV IronXL-a w uporządkowanym folderze i od razu wybrał bezpieczną procedurę. Ładuje XLS z
WorkBook.Loadi daje każdej kolumnie jedno zasady, które testuje własny typ komórki. - Na wejściu zmierzono 200 zamówień CSV, z 43 produktami trzymającymi średnik, 38 cudzysłowem ucieczkowym, i 48 literą nie-ASCII, a 9 z 9 pomiarów kroku 5 mieściło się w zakresie.
- Podsumowanie zawiera 8 formuł SUMIF i 2 formuły SUM z przechowywanymi sumami 5 337 jednostek i 549 169,80 $, plus jeden wykres kolumnowy. Zapisana kopia otwiera się z Q3-review z 250 zamówieniami.
- Niektóre kroki uruchomiono inaczej niż na stronie. Claude Code policzył wiersze CSV z samego pliku, ale wzięte liczby rozpięte na obu plikach z zapisów generatora, podczas gdy
roundtrip.mdmówi, że pochodziły z plików wejściowych. Załadował oba wejścia przezLoadingOptions, którego żadna stronallms.txtlink nie dokumentuje, i sprawdził klucz zenv | grep -c, która wymienia zmienne środowiskowe na licznik. Monity Kroku 1, 3, 5 i 7 podążyły w tej samej sesji. Instalacja pozostawiła przypięcie do 2026.10.1. Monit dokumentacyjny znalazłPhysicalRowCounttylko w dokumentacji API, i zastąpiłLoadingOptionszWorkBook.LoadCSViWorkBook.Load, więc opublikowany plik rundy-tabeli opisuje ten import. Znów pasowało 16 z 16. Monit ustawień zapisał zasady doCLAUDE.mdi zapisałskill.mdjako umiejętność projektu. Samoocena nazwała stronę dokumentacji dla każdego członka, znalazła 69 z 69 próbek komórek w zgodzie, i dopasowała wszystkie 250 wierszy każdego skoroszytu z manifestem. Zmierzyliśmy każde kryterium przejścia ponownie na zapisanych plikach bez IronXL, a świeża wersja Release programu wyprodukowała tę samą tabelę.
Co przechodzi
- Projekt buduje się w Release bez ręcznych edycji.
- Wszystkie 16 wierszy
roundtrip.mdpasuje, a jego regionalne i całkowite wartości równe są sumom plików wejściowych. - Przeszukiwanie folderu projektu pozwala znaleźć klucz licencyjny w żadnym pliku.
Rekord uruchomienia
- Wykonania używają jednego biurka Windows 11 x64 z procesorem Core i9-14900KF i 64 GB pamięci.
- Każdy projekt celuje w .NET 9.
- Każdy przewodnik używa
IronXL.Excel2026.10.1 jako jedynego pakietu IronXL, z wyjątkiem przewodnika Claude Code, którego wykonanie zainstalowało 2026.10.5. ChatGPT Codex dodałMicrosoft.Extensions.DependencyInjection9.0.20 do jego konwertera, a projekty testowe Codex, Copilot, Cursor i Antigravity uruchamiają się na xUnit. - Czas trwania przewodnika to suma zalogowanych czasów zalogowanych monitów na jego stronie, a wiersz tego przewodnika liczy tylko monit akceptacyjny.
- Ostatnio testowane: 15 października 2026 roku z tego przewodnika. Google Antigravity testowano 14 października, Claude Code i GitHub Copilot 13 października, Cursor 9 października, a ChatGPT Codex 7 października 2026 roku.
| Przewodnik | Asystent i wersja | Model | Czas trwania (minuty) |
|---|---|---|---|
| Ten przewodnik | Claude Code 2.1.277, jedna sesja, wyłączone monity o uprawnienia | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, monit 3 w trybie planowania | Claude Sonnet 5, z Claude Opus 5 dla monitu 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, trasowane przez Auto | 14.5 |
| Cursor | Aplikacja desktopowa Cursor 3.23.23 | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 3.8 Flash (Wysoka) | 44.9 |
Przewodniki specyficzne dla agenta
Każdy przewodnik poniżej stosuje powyższe kroki do jednego narzędzia i jednej pracy z arkuszem kalkulacyjnym.
- Użyj IronXL z Claude Code do odczytu miliardowych skoroszytów z strumieniowaniem tylko w jednym kierunku, z pamięcią i czasem mierzonymi w porównaniu do pełnego ładunku skoroszytu
- Użyj IronXL z ChatGPT Codex do konwersji folderu z mieszanymi plikami XLS, XLSX, CSV i TSV na CSV, JSON i XML, z wierszem wyników dla każdego wejścia i obsługą uszkodzonych lub chronionych plików
- Użyj IronXL z GitHub Copilot do stylizacji wyjścia istniejącego rozwiązania raportowania, z testami, które ładują każdy skoroszyt i stwierdzają jego formaty
- Użyj IronXL z Cursor do przenoszenia kodu edytowania skoroszytów z Office Interop, pod zasadami, które trzymają wywołania Interop oraz EPPlus na zewnątrz
- Użyj IronXL z Google Antigravity na stronie ASP.NET Core, która przeprowadza podgląd, walidację i czyszczenie przesłanych skoroszytów, udowodnione przez przesyłanie na żywo w sesji przeglądarki
Rozwiązywanie problemów
- Limity rozmiaru plików IronXL, gdy skoroszyt XLS wyczerpuje wiersze
- Zastosuj klucz licencyjny w IronXL, gdy pierwsze wywołanie skoroszytu wyrzuca LicensingException
- FileNotFoundException dla IronXL.XmlSerializers na .NET 10, gdy debugger przerywa wewnątrz wywołania zapisu, chociaż plik został zapisany
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.