IronXL'yi AI Kod Asistanlarıyla Kullanma
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.
IronXL'yi AI Kod Asistanıyla Kullanma Yöntemi
- NuGet'ten IronXL.Excel paketini alın
- İlk çalışma kitabı çağrısından önce
IronXL.License.LicenseKey'iIronXL_LICENSE_KEY'den atayın - Oturumun başında asistana IronXL'nin
llms.txtdizinini verin - Asistanınızın yükleyeceği talimat dosyasında IronXL kurallarını saklayın
- Yeni bir oturum açın ve tek seferlik kurulum uyarısını gönderin
- Programı oluşturun ve çalıştırın, ardından kendi kendine kontrol uyarısını gönderin
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.Excelve 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.
Bunun yerine terminalden bir sürümü sabitlemek için adını belirtin.
dotnet add package IronXL.Excel --version 2026.10.5
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.
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.
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.txther 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.mdalabilir, 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.
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.
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.
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ütununaBuiltinFormats.Currency2uygulayı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:B2gibi bir sayfa aralığınıRangedeğişkenine atamak hemIronXL.Rangehem deSystem.Rangeile eşleşir ve CS0104 ile başarısız olur.IronXL.Rangeyazın veya bir takma ad ekleyin. - Bir aralıkta çağırılan hücre üyeleri:
A1gibi tek bir hücreyi dizine eklemek hâlâ birIronXL.Rangedöndürür, bu yüzden bu sonuç üzerindeAddCommentçağırmak CS1061 ile başarısız olur.Firstçağırın, böyleceCell'ye ulaşın. - Yanlış okuyucu bir noktalı virgül dosyası için:
WorkBook.Loadbir 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.
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 Alan | Dönüşüm açık | Dönüşüm kapalı |
|---|---|---|
| 000417 (ID) | sayı 417 | metin 000417 |
| 12.50 (fiyat) | sayı 12,5 | metin 12.50 |
| 2026-08-30 (tarih) | metin | metin |
| "Monitor 27" mat"den sonra 2 | metin | metin |
| "Bolt; M8 çinko" | tek alan | tek 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.
| İşlem | XLSX | 2026.10.1'de XLS |
|---|---|---|
| Satır | 1.048.576, sonra atar | 65.536, sonra ArgumentException |
| Grafikler | çalışır | İstisna, mesaj XLSX önerir |
Password, Encrypt, veya SaveAs bir şifre ile | şifreler | ArgumentException, yalnızca .xlsx, .xlsm, .xltx |
| Metin 000501 | metin | metin |
DateTime | tarih | tarih, 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 yok | Yanlış şifre |
|---|---|---|---|
her sayfada Q3-review ile ProtectSheet | 50 4B 03 04 (ZIP) | açılır | açılır |
bir şifre ile WorkBook.Password, SaveAs veya Encrypt, ardından SaveAs | D0 CF 11 E0 (şifrelenmiş) | ArgumentNullException | SecurityException, 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.
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.
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ı
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.Loadile 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.mdise onların giriş dosyalarından geldiğini söylüyor. Her iki girişi deLoadingOptionsile yükledi; bu sayfaya hiçbirllms.txtbağlantı hiçbir belge sunmuyor veenv | grep -cile 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ızcaPhysicalRowCountbuldu veLoadingOptionsyerineWorkBook.LoadCSVveWorkBook.Loadile 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ı veskill.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.
Ç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.Excel2026.10.1 olarak kullanılır, Claude Code kılavuzu çalışmasının tek istisnası 2026.10.5'yi kurdu. ChatGPT Codex, çeviricisineMicrosoft.Extensions.DependencyInjection9.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ılavuz | Asistan ve versiyon | Model | Süre (dakika) |
|---|---|---|---|
| Bu kılavuz | Claude Code 2.1.277, tek oturum, izin uyarıları kapalı | Claude Opus 5 | 16.4 |
| Claude Code | Claude Code 2.1.277, plan modunda uyarı 3 | Claude Sonnet 5, uyarı 3 için Claude Opus 5 ile | 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, Auto ile yönlendirilen | 14.5 |
| Cursor | Cursor 3.23.23 masaüstü uygulaması | Grok 4.7 | 53.1 |
| Google Antigravity | Antigravity CLI 1.3.5 | Gemini 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
- IronXL Dosya Boyutu Sınırları bir XLS çalışma kitabı satırdan çıktığında
- IronXL'de Lisans Anahtarı Uygulama ilk çalışma kitabı çağrısı LicensingException atıldığında
- IronXL.XmlSerializers için .NET 10'da FileNotFoundException kaydetme çağrısı içinde bir hata ayıklayıcı kırıldığında, dosya yazılmış olmasına rağmen
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.