IronXL'yi AI Kod Asistanlarıyla Kullanma

Curtis Chau
Curtis Chau
Güncellendi: 18 Ekim 2026

IronXL, Iron Software'un Excel dosyalarıyla çalışmak için geliştirdiği bir .NET kütüphanesidir. Bu kütüphane, Microsoft Office yüklü olmadan XLSX ve eski XLS çalışma kitaplarını oluşturan, okuyan ve düzenleyen, CSV ve TSV dosyalarını içe aktaran, formülleri değerlendiren ve grafik çizen bir yapıdadır. IronXL, 2019'dan beri NuGet üzerinde bulunmaktadır ve eğitimleri boyunca WorkBook ve WorkSheet kullanmaktadır.

Sınıf isimleri, 2026.10.1 sürümünün verilerinizi nasıl işlediğini göstermez. IronXL'ye hücre değeri olarak "8.27" dizesini verin ve bu, mevcut yılın 27 Ağustos tarihini saklar. Bir CSV'i alan dönüşümü açıkken içe aktarın ve 000417 sipariş kimliği olarak gelir, dosyayı EvaluateAll çağırmadan kaydedin ve bu dosya son düzenlemeden önceki bir formül sonucunu barındırabilir. Bunlardan hiçbiri bir derlemeyi durdurmaz.

Bu sayfa, bu tür işleri yapmak için her türlü asistanı kurar.

  • Sohbet tarzı asistanlar seçtiğiniz kodu yeniden yazar veya editörden yanıtlar.
  • Agentler olarak ChatGPT Codex, Google Antigravity, Claude Code, ve Cursor bir tüm görevi alır, ardından kendi yazdıkları kodu derler ve çalıştırırlar.

İş ister bir CSV ihracatını okumak, formülleri düzenlemek, bir grafik eklemek, ya da bir çalışma kitabını şifrelemek olsun, kurulum her iki durumda da aynıdır.

Claude Code AI kodlama asistanı logosuChatGPT Codex AI kodlama asistanı logosuGitHub Copilot AI kodlama asistanı logosuCursor AI kod editörü logosuGoogle Antigravity AI kodlama ajanı logosu

AI Asistanım Excel'i Kendi Kendine Başaramaz Mı?

Sadece hafızadan, bir asistan eğitimde gördüğü IronXL'yi yazar, bu mevcut sürümde olmayan üyeler içerebilir. IronXL belgelerini araçların okuyabileceği bir biçimde yayınlar, bu nedenle asistan mevcut API'den çalışabilir.

XLSX'e sayı gridini yazmak kolay olan kısımdır. Kütüphaneler arasındaki farklar, formüller, eski XLS girdileri, tedarikçi CSV dosyaları ve dışarıdan kapalı kalması gereken çalışma kitapları ile ortaya çıkar.

  • Office Interop, kodu tek bir masaüstüne bağlar: Interop'a ulaşan bir asistan, kodun çalıştığı her yerde Excel'in kurulu olmasını gerektirirken, IronXL paketi Windows, Linux ve macOS sunucularında çalışır.
  • CSV ayrıştırıcısını yeniden yazmak tokenlara mal olur: Bir agent, IronXL'nin CSV içe aktarmasını, bir kötü içe aktarmadan sonra elle yazılmış bir ayırıcıyla değiştirdiğinde, her deneme için öder ve yeni ayrıştırıcı hâlâ IronXL'nin zaten ele aldığı alıntı kurallarını öğrenmelidir.
  • Paket adı ve ad alanı farklıdır: NuGet ID'si IronXL.Excel ve ad alanı IronXL. Tahmin edilen bir ID, tahmini tutmak amacıyla yayınlanmış benzer bir pakete çözünür, bu saldırı slopsquatting olarak adlandırılır. Tam ID'yi talimatlara yazın.

1. Adım: IronXL'yi Kurun

Paket referanse edilmiş olarak, asistan IronXL'nin gerçek türlerini inceleyebilir.

Add the IronXL.Excel package from NuGet and restore the project.
Then tell me which version the project file references.
Text

Bunun yerine terminalden bir sürümü sabitlemek için adını belirtin.

dotnet add package IronXL.Excel --version 2026.10.5
SHELL

IronXL.Excel 2026.10.5 yalnızca IronSoftware.Common ve IronSoftware.System.Drawing'e bağlıdır.


Adım 2: Lisans Anahtarınızı Uygulayın

IronXL, filigranlı veya sınırlı bir moda geri dönmez. Anahtar olmadan, bir çalışma kitabı oluşturmak, yüklemek veya içe aktarmak IronSoftware.Exceptions.LicensingException atar ve mesaj Üretim Lisansı Gereklidir olur. Yanlış yazılmış bir anahtarla, ilk çağrı Lisans Anahtarı Tanınmadı ile başarısız olur. Aşağıda ücretsiz bir deneme anahtarı bulunmaktadır ve lisans sayfası her kalıcı lisans düzeyi için geliştirici, konum ve proje sayılarını verir.

IronXL'u projenizde kullanmaya bugün ücretsiz deneme sürümüyle başlayın.

İlk Adım:
arrow pointer

Anahtarı program başladığında, başka herhangi bir IronXL çağrısından önce bir kez ayarlayın ve IRONXL_LICENSE_KEY ortam değişkeninden çekin, bu onu kaynak kontrolünden çıkarır.

IronXL.License.IsLicensed, geçerli bir anahtar uygulandıktan sonra doğru döner ve IronXL.License.IsValidLicense, verilen bir anahtarın geçerli ve süresiz olup olmadığını bildirir. İstisna tipi dahildir, bu yüzden ismini veren bir catch deyimi derlemez ve CS0122'yi bildirir. Başlangıçta IsLicensed kontrol edin, ya da Exception yakalayın ve mesajı okuyun.

Lütfen dikkat: Lisans Anahtarlarını Uygulama, anahtarı Web.config veya appsettings.json içinde nasıl saklayacağınızı gösterir.

3. Adım: Asistanınızı IronXL'nin LLM Belgelerine Yönlendirin

  • llms.txt her sayfa için bir satırla bağlantılandırılmış bir dizindir ve her oturumun başında bulunmalıdır.
  • 94 sayfanın özetleri llms-full.txt'deki bir dosya ile gelir, bu geniş sorular için uygundur.
  • llms-full-catalog.txt, karşılaştırmalar ve blog kılavuzları için dizine her blog yazısını ekler.
  • API Referansı her ad alanı, tür ve üyeyi listeler.
  • Yetenek dosyalarını yükleyen araçlar skill.md alabilir, bu, kurulum, lisanslama, tarifler ve yaygın hataları kapsar.
  • AI Ürün Bilgi Formu bir sayfa arka plan bilgisi verir.
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

Bir görev tek bir rehbere bağlı olduğunda, asistandan o sayfayı açmasını isteyin.


4. Adım: IronXL Bağlamını Projenize Ekleyin

Sohbet talimatları, sohbet kapandığında kaybolur. Bir proje dosyası, oturum her açıldığında tekrar okunur, bu yüzden zaten ekibinizin tuttuğu dosyaya IronXL kurallarını ekleyin. Claude Code CLAUDE.md, ChatGPT Codex AGENTS.md ve GitHub Copilot .github/copilot-instructions.md okur. Cursor .mdc dosyalarını .cursor/rules/ veya AGENTS.md'de okur. Google Antigravity AGENTS.md veya GEMINI.md okur. Kurallar her dosyada aynı şekilde okunur.

## 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

Yetenek dosyası şifreleme, sayfa koruması ve EvaluateAll doğru yapar. Önde gelen sıfırlar veya tarih dönüşümü hakkında uyarı vermez, bu yüzden bu iki satırı kendi dosyanızda saklayın. Tek dosya örneği hala NuGet'teki 2026.10.5 paketi olan sürümden üç geri 2026.8.1'i sabitler, bu yüzden projenizin kullandığı sürümü güncelleyin.


5. Adım: Anında Kurulum Komutu

1'den 4'e kadar adımlar bir mesaja sığar. Proje başladığında veya herhangi bir yeni oturumda gönderin.

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
İpuçları: Bir kez gönderildikten sonra Adım 4 proje dosyasını açın ve kuralların içine yerleşip yerleşmediğini kontrol edin.

6. Adım: Çalışan Kod Üreten Talimat Desenleri

Sayfayı, hücreleri ve formatı adlandırın. Asistan, hangi hücrelerin önemli olduğunu veya işin hangi dosya formatına ihtiyaç duyduğunu tahmin edemez.

Belirsiz Siparişlerimizi IronXL ile bir Excel raporuna dönüştürün.

Daha İyi Çalışma kitabını WorkBook.Create(ExcelFileFormat.XLSX) ile oluşturun, siparişleri Kalın, donmuş başlık satırına sahip Siparişler adlı bir sayfaya yazın, Birim Fiyatı sütununa BuiltinFormats.Currency2 uygulayın ve her bölgedeki SUMIF'i bir Özet sayfasında koyun.

Sürüm ve çerçeveyi belirtin. Davranış sürümler arasında değişiklik gösterir ve bir versiyona sahip olmayan bir asistan eski ve yeniyi karıştırabilir.

Daha İyi .NET 9 ve IronXL.Excel 2026.10.5'i hedefleyin.

Tüm dosyaları isteyin. Bir parça using direktiflerini kaybeder, bu önemlidir çünkü BuiltinFormats, IronXL.Formatting'da ve ChartType, IronXL.Drawing.Charts'da bulunur.

Daha İyi Her using direktifi ve lisans ataması ile birlikte bütün Program.cs'u döndürün, böylece olduğu gibi derlenebilir.


7. Adım: Geri Aldığınız Şeyi Doğrulayın

Bunlardan her biri 2026.10.1'de tekrar edilir.

  • Belirsiz bir Range: Dolaylı usings ile, A1:B2 gibi bir sayfa aralığını Range değişkenine atamak hem IronXL.Range hem de System.Range ile eşleşir ve CS0104 ile başarısız olur. IronXL.Range yazın veya bir takma ad ekleyin.
  • Bir aralıkta çağırılan hücre üyeleri: A1 gibi tek bir hücreyi dizine eklemek hâlâ bir IronXL.Range döndürür, bu yüzden bu sonuç üzerinde AddComment çağırmak CS1061 ile başarısız olur. First çağırın, böylece Cell'ye ulaşın.
  • Yanlış okuyucu bir noktalı virgül dosyası için: WorkBook.Load bir virgüllü dosyayı sütunlara böldü, ancak bir noktalanmış virgül dosyasının her tüm satırını A sütununa koydu ve kutu içine alınmış alanlarla bir noktalanmış virgül dosyasında FileLoadException attı. Ayırıcıyı WorkBook.LoadCSV'e geçirin, tıpkı CSV okuma rehberi gibi.

Ajanın Kendi Çalışmasını Doğrulamasına İzin Verin

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 Alan ve Hücre Değer Dönüşümü

Tür dönüşümü iki yerde gerçekleşir. Bu sonuçlar, .NET 9'da IronXL.Excel 2026.10.1'den elde edilmiştir.

WorkBook.LoadCSV bir convertFieldValues bayrağı alır ve varsayılan olarak true'dur.

CSV'deki AlanDönüşüm açıkDönüşüm kapalı
000417 (ID)sayı 417metin 000417
12.50 (fiyat)sayı 12,5metin 12.50
2026-08-30 (tarih)metinmetin
"Monitor 27" mat"den sonra 2metinmetin
"Bolt; M8 çinko"tek alantek alan

Alıntılar, RFC 4180'de açıklandığı gibi çalışır ve Bayt sırası işaretçili veya işaretsiz UTF-8 adları, aksanlı Cafe gibi içe aktıldığında hayatta kaldı. Kaçış sembolü kullanılan bir alıntılı satır, sonraki alanını metin olarak tuttu ve SUM ve SUMIF metni yok sayarken, aynı hücreleri çarpan bir formül hala çalıştı.

İkinci yer Value ayarlayıcısıdır. Bir hücre değeri olarak atanan bir dize ayrıştırılır ve ay şekline sahip dizeler hafta gelir. Testlerimizde "1.5" 5 Ocak 2026 olarak saklanırken, "2026-08-30" 30 Ağustos 2026 olarak, "12.50" ve "000417" ise metin olarak kaldı.

Böylece CSV alanlarını dize olarak kopyalayan bir içe aktarma, 8.27 fiyatını 46.261 civarında bir tarih serisine çevirebilir. Güvenli kalıp, dönüşümler kapalı olarak içe aktarmak, her sütunu sabit kültürle ayrıştırmak ve int, decimal, double veya DateTime değerlerini atamaktır.


Kaydedilen Dosyadaki Formül Sonuçları

IronXL, okuduğunuzda formülleri hesaplar, bu yüzden çalışma kitabını IronXL aracılığıyla yeniden yükleyen bir kontrol her zaman güncel cevabı görür. Kaydedilen dosya farklı bir konudur. openpyxl ve pandas gibi hesaplama yapmayan okuyucular yalnızca dosyanın sakladığı sonuçları görür.

Testlerimizde, daha önce hiç okunmamış veya değerlendirilmemiş bir formül, SaveAs ile yazıldı ve depolanmış bir sonuç elde edilmedi. Bir kez okunan, ardından girdisinin değiştiği ve kaydedilen bir formül, dosyada eski sonucu tuttu. IronXL, yeniden yükledikten sonra yeni toplam 43'ü bildirdi, openpyxl ise saklanan 5'i okurlar. EvaluateAll'dan sonra ve SaveAs sonrasında, her formül kendi güncel değerini taşıdı. formül düzenleme kılavuzu, aynı neden için EvaluateAll çağırır.

Kendi kendine zengin metinlerin karşılaştırılmasına rağmen, IronXL geri dönmezken, formül metni otomatik olarak doğru hesaplanacak. Bir Özet sayfasındaki SUMIF, Siparişler sayfasının aralıkları üzerinde düzgünce değerlendi, kaydedildi ve değeriyle birlikte yeniden yüklendi.


IronXL Tarafından Döndürülen Formül Metni

Her Sipariş satırının Gelir formülünü tuttuğunu kontrol askıya, formül metnini karşılaştırabilir, ancak IronXL verilen dizeyi geri vermez. 2026.10.1'deki =E2*F2 hücre G2 üzerine atanmış, ve Formula özelliği, kayıttan önce ve bir yeniden yüklemeden sonra hiçbir eşitlik işareti olmadan E2*F2 döndürmüştür. Bu, sayfa XML içindeki formül elementinin içeriğidir. Cell.Formula için IronXL'nin kendi XML belgeleri =A2+A2+A3+A4 örneğini verir ve formül düzenleme rehberi formülleri yazar ancak sadece sonuçlarını geri okur.

Eşitlik işareti olmadan yazılan bir formül geriye doğru bozulmadan okunur ve Value üzerinden atanan bir formül de eşitlik işaretini aynı şekilde kaybeder. Basit bir sayı tutan bir hücre null döndürür. IronXL, kendisine verilen büyük/küçük harf kullanımı ve boşluğu tutar, bu yüzden =e5 * f5 geri okunduğunda e5 * f5 olarak okunur.

Yani, doğru bir çalışma kitabında formül metnini =E2*F2 ile karşılaştıran kendi kontrolü başarısız olur. Aşağıdaki talimatta, bu tür yanlış bir başarısızlık, temsilciyi zaten doğru olan raporlama kodunu değiştirmek için adım 11'e yeniden gönderebilir.

Bütün sütunlarda ikincil bir tuzak var. Çok hücreli bir aralıktaki Formula özelliği tüm hücreler aynı formülü tutmadıkça null döndürür. Dört doğru satır formülü için G2:G5 aralığı null vermişti, hiç formül tutmayan E2:E5 için de aynı yanıtı vermişti. Her Cell üzerinde IsFormula test edin ve formül metnini yalnızca beklenen dizgiden = çıkarıldıktan sonra karşılaştırın.


XLS Çıktı Sınırları

Daha eski sipariş ve muhasebe sistemleri hala XLS olarak dışa aktarır ve IronXL bunu okuyup yazar. Yazmak, XLSX'in sahip olmadığı sınırlara sahiptir.

İşlemXLSX2026.10.1'de XLS
Satır1.048.576, sonra atar65.536, sonra ArgumentException
Grafiklerçalışırİstisna, mesaj XLSX önerir
Password, Encrypt, veya SaveAs bir şifre ileşifrelerArgumentException, yalnızca .xlsx, .xlsm, .xltx
Metin 000501metinmetin
DateTimetarihtarih, IsDateTime yeniden yüklemeden sonra doğru

IronXL'nin yazdığı bir XLS dosyası, özgün bir Excel 97-2003 çalışma kitabıdır. İlk sekiz baytı, bileşik dosya imzası olan D0 CF 11 E0 A1 B1 1A E1'dır, bu bir asistanın XLSX içeriğini .xls adının altında kaydetmediğini doğrulamak için hızlı bir yoldur.


Sayfa Koruması ve Dosya Şifreleme

"şifre korumalı çalışma kitabı" isteyin ve bir asistan iki IronXL özelliğinden birini seçebilir. Farklı davranışlar sergilerler.

Şunlarla kaydedildiİlk baytlarŞifre yokYanlış şifre
her sayfada Q3-review ile ProtectSheet50 4B 03 04 (ZIP)açılıraçılır
bir şifre ile WorkBook.Password, SaveAs veya Encrypt, ardından SaveAsD0 CF 11 E0 (şifrelenmiş)ArgumentNullExceptionSecurityException, Geçersiz şifre

Dört şifrenin hepsi doğru şifreyle açılır. ProtectSheet, Excel içinde düzenlemeleri durdurmayı amaçlar ve hiçbir şeyi şifrelemez. Gereksinim yabancıların dosyayı okuyamamasıysa, adını belirtip şifreleme isteyin, tıpkı çalışma kitabı şifre rehberi gibi. Encrypt ayrıca şifreli çalışma kitabını bir akış olarak geri döndürür ve şifreyi üzerine kaydeder, bu yüzden ardından gelen SaveAs şifreli bir dosya yazar. Şifre ile WorkBook.Load sonucu açar.


Yenileyebileceğiniz Bir Sonuç

Test bir yönlendirme ve sizden hiçbir kod istemez. Boş bir klasörde yeni bir oturum açın, istemi yapıştırın ve geri gelenleri altındaki geçiş listesiyle karşılaştırın.

Lütfen dikkat: .NET 9 SDK, bir ağ bağlantısı, terminal komutlarını çalıştırma izni olan bir asistan ve IRONXL_LICENSE_KEY içinde bir IronXL deneme veya üretim anahtarı gerekir.

İstem

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

Yönlendirmeyi, IronXL 2026.10.1 ve tohum 2026 üzerindeki bir referans programıyla kalibre ettik. LoadCSV ile XLSX formatında, noktalı virgül ayırıcı ile ve alan dönüşümü açıkken, sonra dönüştürülmüş değerleri kopyalayarak, 16 satırdan 9'unu eşleştirdi. Tüm 200 CSV Sipariş Kimliği ön sıfırlarını kaybetti ve kaçış sembolü içeren 48 miktar metin olarak kaldığı için her bölgenin birimleri eksik kaldı. Dönüştürme kapalı olarak içe aktarma ve dizeleri kopyalama 16'da 8 eşleşti çünkü 8.27 ve 10.11 fiyatları tarihe dönüştürüldüğünden, Kuzeyin gelirini gerçek değerinin 3,9 katına ve Güney'in 2,9 katına itti. Her sütunu açıkça çözümleyip ve yazılan tipli değerleri, tohumlar 2026, 77, 4101 ve 12345 üzerinde 16'da 16 eşleşti. Bu kılavuzun önceki bir taslağı, ASCII ürün adlarıyla, çıplak sayısal ID'lerle ve aynı raporu oluşturan aynı kodla okunan eski toplamlarla IronXL 2026.9.2 üzerinde 9'da 9 geçti, bu yüzden çok az test etti.

Çıktı

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

Bu resim, çalışmanın sales-report.xlsx'inde Özet sayfasının bir rendering'idir; kaydedilen dosyanın sakladığı değerler ve grafiklerden çizilmiştir ve Excel'de çekilen bir ekran görüntüsü değildir. Çalışmanın düzenlenmemiş gidiş-dönüş tablosu her adım 5 ölçümünü, içe aktarma prosedürünü ve 16 satırı kapsar.

  • Programın ilk yürütülmesi adım 5 kontrolünde durdu çünkü hem Kuzey hem Güney 90 siparişe sahipti ve gelirleri 921,94 ayrıyken. Claude Code, bölge paylarını genişletti, girdileri yeniden oluşturdu ve bir sonraki yürütmede tüm 16 satırı eşleştirdi, bu yüzden 11. adımda tamir döngüsü hiç çalışmadı.
  • Bu çalışmanın orders.csv'inde, dönüşüm açıkken yükleme, ön sıfırla metin olarak kalan 200 Sipariş Kimliğinden hiçbirini ve 38 miktarı metin olarak tuttu, bu yüzden belirgin ithalat burada da başarısız olurdu.
  • Programı yazmadan önce, Claude Code bir taslak klasöründe IronXL'nin CSV ithalatını denedi ve güvenli prosedürü baştan belirledi. XLS'yi WorkBook.Load ile yükler ve her sütuna hücrenin kendi türünü test eden bir kural verir.
  • Girişler 200 CSV siparişi ölçtü, 43 ürün noktalı virgül içerirken, 38'i kaçış sembolü ve 48'i ASCII olmayan bir harf tuttu ve adım 5 ölçümlerinin 9'u aralıkta kaldı.
  • Özet, toplamları 5.337 ünite ve $549.169,80 olan 8 SUMIF ve 2 SUM formülü ile bir sütun grafiği tutar. Şifrelenmiş kopya, 250 siparişe Q3-review ile açılır.
  • Bazı adımlar sayfadan farklı çalıştı. Claude Code, kendi dosyasının CSV satırlarını saydı, ancak hem dosyaları kapsayan rakamları üreteç kayıtlardan aldı, roundtrip.md ise onların giriş dosyalarından geldiğini söylüyor. Her iki girişi de LoadingOptions ile yükledi; bu sayfaya hiçbir llms.txt bağlantı hiçbir belge sunmuyor ve env | grep -c ile anahtarı kontrol etti, bu ortam değişkenlerini bir sayıya listeler. 1. Adım, 3, 5 ve 7 uyarıları aynı oturumda takip etti. Kurulum 2026.10.1 pinini korudu. Belgeler uyarısı, API referansında yalnızca PhysicalRowCount buldu ve LoadingOptions yerine WorkBook.LoadCSV ve WorkBook.Load ile değiştirdi, bu yüzden yayınlanmış gidiş-dönüş dosyası bu ithalatı tanımlar. 16'da 16 yine eşleşti. Kurulum uyarısı, kuralları CLAUDE.md'e yazdı ve skill.md'u bir proje yeteneği olarak kaydetti. Kendi kendine kontrol, her üye için bir belge sayfasını adlandırdı, örneklenen hücrelerden 69'da 69'unu uyumlu buldu ve her çalışma kitabının 250 satırının her biri ile manifestoyu eşleştirdi. IronXL olmadan kaydedilen dosyalar üzerindeki her geçiş kriterini yeniden ölçüştürdük ve programın taze bir Sürüm derlemesi aynı tabloyu üretti.

Geçen şeyler

  • Proje, hiçbir manuel düzenleme olmaksızın Sürümde inşa edilir.
  • roundtrip.md'ın tüm 16 satırı eşleşir, bu sayı ve bölgesel ve toplam rakamlar giriş dosyalarının toplamlarına eşittir.
  • Proje klasörü araştırması, lisans anahtarını hiçbir dosyada bulmaz.
Lütfen dikkat: Farklı bir sürümü denemek için, adım 1'de sürümü düzenleyin ve IronXL sürüm geçmişini okuyun ve de neler değiştiğini görün.

Çalıştırma kaydı

  • Çalışmalar, bir Core i9-14900KF ve 64 GB bellek ile bir Windows 11 x64 masaüstü bilgisayarı kullanır.
  • Her proje .NET 9'u hedefler.
  • Her kılavuz, yalnızca IronXL paketi IronXL.Excel 2026.10.1 olarak kullanılır, Claude Code kılavuzu çalışmasının tek istisnası 2026.10.5'yi kurdu. ChatGPT Codex, çeviricisine Microsoft.Extensions.DependencyInjection 9.0.20 ekledi, ve Codex, Copilot, Cursor ve Antigravity test projeleri xUnit üzerinde çalışıyor.
  • Bir kılavuzun süresi, sayfasındaki istemlerin kaydedilmiş sürelerinin toplamıdır ve bu kılavuzun satırı sadece kabul uyarısını sayar.
  • Son test: Bu kılavuzun çalışması ile 15 Ekim 2026. Google Antigravity, 14 Ekim, Claude Code ve GitHub Copilot, 13 Ekim, Cursor 9 Ekim ve ChatGPT Codex 7 Ekim 2026'da test edildi.
KılavuzAsistan ve versiyonModelSüre (dakika)
Bu kılavuzClaude Code 2.1.277, tek oturum, izin uyarıları kapalıClaude Opus 516.4
Claude CodeClaude Code 2.1.277, plan modunda uyarı 3Claude Sonnet 5, uyarı 3 için Claude Opus 5 ile53.8
ChatGPT CodexCodex CLI 0.160.0GPT-6 Luna59.0
GitHub CopilotGitHub Copilot CLI 1.0.97GPT-6 Luna, Auto ile yönlendirilen14.5
CursorCursor 3.23.23 masaüstü uygulamasıGrok 4.753.1
Google AntigravityAntigravity CLI 1.3.5Gemini 3.8 Flash (Yüksek)44.9

Ajan'a Özgü Kılavuzlar

Aşağıdaki her kılavuz, yukarıdaki adımları bir araç ve bir elektronik tablo işi için uygular.

  • Claude Code ile IronXL'yi Kullanma ileri-tek yönlü akış ile milyon satırlık çalışma kitaplarını okuma için, belleği ve zamanı tam bir çalışma kitabı yüklemesi karşısında ölçme
  • ChatGPT Codex ile IronXL'yi Kullanma karışık XLS, XLSX, CSV ve TSV dosyalarından bir klasörü CSV, JSON ve XML'ye dönüştürmek için, her giriş için bir sonuç satırı ve bozulmuş veya korumalı dosyaları ele alma
  • GitHub Copilot ile IronXL'yi Kullanma mevcut bir raporlama çözümünün çıktısını biçimlendirme için, her çalışma kitabını yeniden yükleyen ve biçimlerini onaylayan testlerle
  • Cursor ile IronXL'yi Kullanma Office Interop'tan çıkma kuralları altındaki çalışma kitabını düzenleme kodunu taşıma için, Interop ve EPPlus çağrılarını dışarıda tutma
  • Google Antigravity ile IronXL'yi Kullanma bir ASP.NET Core sayfası için ki bu sayfa yüklenen çalışma kitabını önizler, doğrular ve temizler, canlı bir tarayıcı oturumu ile kanıtlanır

Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 2,393,101Sürüm:2026.11yeni çıktı