如何使用IronXL與Google Antigravity
一個工作簿上傳頁面可以編譯,通過其整合測試,但仍可能在第一個供應商發送大價格表、受密碼保護的工作簿或重命名的CSV檔案時失敗。
Google Antigravity的/browser命令將頁面交給Chrome子代理,該子代理選擇上傳表單中的每個測試工作簿,提交它,並保留回應的截圖。 IronXL直接從請求流在伺服器上打開上傳,不涉及Office安裝,使用WorkBook.Load。 本指南建立了一個供應商價格表頁面。 頁面顯示預覽表,根據書面規則驗證每一行,返回清理過的XLSX文件,每個步驟都有截圖和結果表作證。
在Antigravity中開啟MVC專案後,請求上傳頁面。
/plan Build a supplier price list upload at /PriceList in this ASP.NET Core MVC app on .NET 9.
- A supplier picks an .xlsx or .xls file in a multipart form.
- The server opens it with WorkBook.Load straight from IFormFile.OpenReadStream.
- Use IronXL from the IronXL.Excel 2026.10.1 package. The namespace is IronXL.
- The page shows a preview table, a validation summary and a link to a cleaned XLSX download.
- docs/price-list-rules.md defines every rule and message.
Set IronXL.License.LicenseKey once in Program.cs from IRONXL_LICENSE_KEY.
The app reads that variable on its own, so don't print its value or list environment variables.
Keep the key out of every file.
In the Implementation Plan, tell me:
- which request body limit applies before the action runs
- how the page tells a password-protected workbook from a damaged file
- how text cells get written into the cleaned workbook
Then get dotnet build passing with no errors.
在您批准此計畫之前,閱讀其的兩部分。 Kestrel在MVC綁定表單之前拒絕任何超過30,000,000 bytes的請求體,因此動作內的大小檢查不會執行於更大的文件。明智的計畫會像微軟的文件上傳指南所描述的,使用[RequestSizeLimit]和[RequestFormLimits]來提升此動作的上限,並在其後保持自己的10 MB檢查。 屬性覆蓋Kestrel的伺服器全域限制,對該請求而言,計畫因此不需要在Program.cs中使用更大的MaxRequestBodySize,這將提升每個端點的上限。 計畫還應將需要密碼的工作簿與非工作簿的檔案分開,因為IronXL對每者都拋出不同的例外。 在非互動模式下,agy -p會自動進行計畫檢查,如Antigravity變更記錄所述,因此您在隨後檢查代碼變更時應一併檢查計畫Artifact。
只需給代理變數名稱,因為輸入的密鑰可能會留在源,提交,或命令記錄中。 甚至變數的值也可能洩露。 在早期的運行中,代理用PowerShell命令檢查IRONXL_LICENSE_KEY是否已設置並顯示其值。 密鑰進入模型並存在於Antigravity自己的謄寫檔案中位於~/.gemini/antigravity-cli/之下,儘管在版本庫中無任何文件持有它。
授權密鑰指南詳細介紹IronXL檢查密鑰的所有位置。
最小工作流程(5 個步驟)
- 從NuGet下載C# Excel程式庫
- 從可在localhost構建及服務頁面的ASP.NET Core MVC應用程序開始
- 提交所有上傳規則及每個測試工作簿的預期結果
- 讓
/browser上傳每本工作簿並截圖顯示的頁面 - 用
WorkBook.Load重新加載每個清理過的下載,並計算其被接受和拒絕的行數
Google Antigravity是什麼,它與聊天助手有何不同?
給予一個目標,Antigravity代理生成計畫,並在編輯器、終端和瀏覽器中實施,還以您可以檢視的Artifacts報告此過程而不是對話記錄檔。
沒有指導的情況下,建立上傳頁面的代理可能會選擇它找到的第一個Excel程式庫或猜一個包名稱。 猜測的名稱可能解決為攻擊者預先以該名稱發併的假冒品,這種做法稱作slopsquatting。 使用IronXL.Excel作為包,並使用IronXL作為命名空間。
AI編碼助理指南列出了需要提供給代理的IronXL文檔鏈接,並包含您可以在Antigravity中運行的單一提示接受測試。
代理返回什麼,您如何審核?
在代碼之前,實施計劃
此計劃描述文件。 審查以確認範圍。
在運行過程中,代碼差異
代碼差異顯示計劃的實施方式。 檢查POST動作的屬性,每個catch子句中的例外類型,以及寫入清理後工作簿的每一行。 在接受之前查找每個更改所使用的IronXL成員在API參考中。
在運行後,進階導覽
進階導覽總結更改並保存結果的證據。 每個截圖被保存為可接受評論的圖片Artifact。 如果其中一個顯示錯誤的值,例如一個數字顯示為日期,請對此截圖評論,且不要在新提示中描述問題。
我們的CLI對話從第一個提示到最後一個提示保留了一個walkthrough.md,並在每個任務中替換其內容,因此早期提示的七文件表只存在於代理的回應中。 一旦提示完成,請保留每個表的副本。
如何在真正瀏覽器中測試IronXL上傳頁面?
請求只有真正上傳才能填滿的結果表。
/browser Start PriceListImport with dotnet run as a background task and open /PriceList.
Its http profile serves http://localhost:5289.
For each file listed in TestData/uploads/expected.csv:
1. Choose it in the upload form and submit.
2. Wait for the page to settle, then take a screenshot.
3. If the outcome column says password, type that row's password, pick the file again and resubmit.
In the Walkthrough, give me one row per file with:
- its size in bytes
- the expected outcome
- what the page showed, either its accepted and rejected counts or the message text
- the EffectiveDate in the first preview row, when there is a preview
- pass or fail against its expected.csv row
If a row doesn't match, quote the server log line or error page behind it before you touch the code.
After every fix, start the app fresh and redo the whole seven-file pass.
Stop the app when you're done.
更高的請求上限改變了一個文件的結果,但新的日期解析影響了每個預覽,因此只有每次修正後對所有七個文件的完整通過才能顯示其他沒有損壞的部分。 首先尋求日誌行還意味著您在審核編輯之前先審核原因。
是什麼導致Excel值錯誤或丟失?
下面的每個失敗都追溯到一個原因,並且在後續任務中命名它可以為代理節省一段試錯時間。
我們從IronXL的ASP.NET MVC指南改編了控制器以讀取上傳的表單文件而不是固定路徑,增加了10 MB長度檢查,並通過headless Chrome上傳了七個測試工作簿。 下面的每個失敗都幹淨編譯。
| 截圖 | 原因 | 請求修正 |
|---|---|---|
| 「此網站無法達到」用於32.7 MB文件 | Kestrel的預設數據主體限制 | 在應用程式上限之上的[RequestSizeLimit]和[RequestFormLimits],加上其自身的大小消息 |
| 工作簿受密碼保護,但未提供密碼。 (參數 'password') | 該頁面顯示ex.Message來自ArgumentNullException | 一個密碼欄位和您自己的訊息 |
| 8行以分號連接的文字在兩列中 | 重命名的CSV不拋出例外即加載 | 首先檢查標題行 |
| 小文件的內存不足訊息 | 截斷的工作簿拋出FileLoadException | 「不是可讀的工作簿」 |
| 「2026-11-01 12:00:00 AM」, 或「46327」為XLS日期 | 讀取原始值或DataTable,以及IronXL未檢測到的XLS日期格式 | FormattedCellValue 及 DateTime.FromOADate 用於序列 |
在探測中,一個空檔案,一個PNG圖像和一個純文本檔案也沒有拋出例外載入,因此標題檢查比任何catch區塊拒絕更多的錯誤上傳。
如何設置一個Antigravity可以工作的專案?
從已經編譯和提供首頁的應用程序開始。 dotnet new mvc --framework net9.0創建一個。 啟動一次並從Properties/launchSettings.json拷貝http地址,因為每個新專案都獲得其自己的端口號,而/browser提示必須使用它。 將該地址保留在http://localhost:<port>表單中,因為瀏覽器的允許列表最初僅保存localhost,而任何其他地址等待有人點擊始終允許。
將測試工作簿提交到TestData/uploads,用一個expected.csv記錄每個的結果,並將規則寫入docs/price-list-rules.md。 我們的一組包含需要清理的價格表,一個舊版的XLS導出,一個有受保護工作表的工作簿,一個加密的工作簿,一個截短的下載,一個重命名的CSV和一個32.7 MB的工作簿。 然後讓代理檢查包和密鑰。
Tell me which IronXL.Excel version PriceListImport.csproj references.
Quote its PackageReference line, then list every file that mentions a license key.
The key rules are:
- The key comes from IRONXL_LICENSE_KEY at startup and from nowhere else.
- Neither appsettings file has an IronXL.LicenseKey entry.
- A missing variable produces one startup warning that names it and prints no value.
Add that warning if the app doesn't have it yet. Leave everything else as it is.
在任何後續提示中,命名該版本增加或更新包,以便沒有任務悄悄升級或降級IronXL。
沒有密鑰,每次上傳在讀取調用時都會失敗並發出「需要生產授權」的LicensingException。 一個捕獲每個例外並聲稱文件不可讀的頁面接著會將每個供應商的問題歸咎於伺服器問題,這是僅捕獲預期例外的另一個原因。
Antigravity依據其規則文檔,從專案中的AGENTS.md,GEMINI.md和.agents/rules/*.md載入規則。 在.agents/rules/中的文件需要YAML前置訊息和有效的trigger,Google警告稱,沒有前置訊息或未辨識到的觸發器的規則會被靜默丟棄。 一個glob觸發器僅在代理處理匹配文件時載入規則,適合針對一個控制器和一個服務的規則。
/learn將會話的修正轉變為規則或技能。 指令頁說它寫入.antigravity/rules.md,但規則頁沒有列出該路徑為規則載入的地方,因此請在提示中命名文件。
/learn Save what this session settled about the upload page as a glob rule.
Write it to .agents/rules/price-list-upload.md.
Give it YAML frontmatter with trigger: glob.
Its globs cover Controllers/**, Services/** and Views/PriceList/**.
The rule should cover:
- the request limits, with the reason for each value
- the exceptions IronXL throws for a missing password, a wrong password and an unreadable file
- how text that starts with = gets written
- how legacy XLS dates are read
- that no upload change is finished until the seven-file /browser check passes for TestData/uploads
打開新文件並檢查其首行前置訊息和蛇形命名法觸發值如always_on,永遠不要使用駝峰命名法alwaysOn。 也請閱讀globs值。 規則頁將其類型設為逗號分隔的字串,且不描述YAML列表。
如何使用IronXL載入上傳的工作簿?
在ASP.NET Core源中,IFormFile.OpenReadStream將表單節包裹在ReferenceReadStream中,之所以有可尋址特性是因表單讀取器在記憶體中緩衝每個文件64 KB,剩餘部分放在暫時文件中。IronXL需要一個可以尋址的流。 我們通過一個只能前進的流將每個測試工作簿傳入WorkBook.Load,所有七個都拋出NotSupportedException,提示「指定的方法不受支持」。上傳流報告自己支援尋址,而IronXL從中讀取每次上傳而不需複製。
10 MB封頂保護的是記憶體更多於頻寬。 載入32.7 MB的測試文件,260,001行包含標題在內,橫跨6列,耗時6.6秒,峰值732 MB的工作集中於主控台探測。 IronXL的文件大小限制頁面聲明IronXL自身不設置文件大小或行限制,因此封頂屬於應用程序。設置自供應商發送的最大價格表,並從規則中保持5,000行限制作為第二檢查。
Plan the refactor below in an Implementation Plan Artifact, then wait for my review before editing.
Move all the IronXL work out of the controller into Services/PriceListImporter.cs.
Register the service as a singleton.
The controller:
- keeps the request limits and the 10 MB check
- passes the upload stream to the service, with the password or null when the field is empty
- keeps the cleaned bytes for the download link
The service owns the header row check. It catches three IronXL failures and nothing else:
- a missing password, which throws an ArgumentNullException whose ParamName is password
- a wrong password, which throws a System.Security.SecurityException
- a file that can't be read, which throws a System.IO.FileLoadException
An IronSoftware.Exceptions.LicensingException has to reach the error page and the log.
So does any other failure.
Once the build passes, repeat the browser upload check on all seven workbooks.
當更改抵達時,將載入步驟與以下版本對比。 它編譯對比於IronXL 2026.10.1,擁有相同的三個捕獲子句,我們的校準頁面在每一個七個測試文件上達到預期結果。
using IronXL;
public sealed class PriceListImporter
{
public ImportResult Import(Stream upload, string? password)
{
WorkBook workBook;
try
{
workBook = string.IsNullOrEmpty(password)
? WorkBook.Load(upload)
: WorkBook.Load(upload, password);
}
catch (ArgumentNullException ex) when (ex.ParamName == "password")
{
return ImportResult.AskForPassword("This workbook is password-protected. Enter its password to open it.");
}
catch (System.Security.SecurityException)
{
return ImportResult.AskForPassword("That password did not open the workbook. Try again.");
}
catch (FileLoadException)
{
return ImportResult.Failed("This file is not a readable Excel workbook. Upload an .xlsx or .xls file.");
}
WorkSheet sheet = workBook.WorkSheets.First();
return Validate(sheet);
}
}
ImportResult和Validate代表應用程序的結果類型及規則檢查。
如何建立預覽表?
被要求預覽的代理可以將載入的工作簿傳入WorkBook.ExportToHtmlString並將結果顯示在視圖中。 IronXL的Excel到HTML示例使用HTML導出方法和選項類寫入文件,且頁面僅描述五個顯示選項。 我們的探測對頁面預覽的四個測試工作簿執行字串導出。 良好的價格表,受保護的工作表文件和用密碼打開的加密文件各自拋出InvalidOperationException,提示「可空物件必須有值」。舊版的XLS文件出口其13行中的12行,缺少PL-3012。
這三個文件來自openpyxl,其預設單元填充沒有patternType屬性,IronXL內部的HTML轉換器在該填充上失敗。 當我們在其中加入patternType="none"後,良好的價格表導出,缺少最終行PL-2007。每個導出過的工作簿都失去其最後一行,包括由IronXL創建的三行工作簿,且舊版日期仍以46337等序列號形式出現。
導出確實編碼了單元格文本,因此使用img標籤帶src=x和onerror警報的說明文本出現時,括號被逃逸了。 改在Razor視圖中從工作表的單元格構建預覽,因此驗證計數的每行顯示在螢幕上,且Razor編碼每個值。 如果代碼更改呼叫字串導出,請要求代理替換它。
如何將文本單元格寫入已清理的工作簿?
我們的測試價格表中的某一行有一個描述,它是以=HYPERLINK(開頭的純文本。 IronXL回讀時仍作為文本,與供應商儲存的完全一致。 通過Value或StringValue將該字串寫入清理後的工作簿,而IronXL則存儲一個即時的HYPERLINK公式。 兩個寫入重新加載後為公式,保存的表格XML為單元格包含<f>元素。 寫入指南建議強制使用StringValue以獲得準確的值,而在IronXL 2026.10.1中對於如+SUM(1,2)或@SUM(1,2)的文本有效,但不適用於以=開始的文本。
一個前置撇號可以修正它。 StringValue = "'" + text以無公式共享字符串形式存儲字串的其餘部分,就像Excel中以撇號打字的單元格處理方式一樣,而回讀時顯示為原始文本。 在指定值之前將單元格的FormatString設置為"@", 文本格式,也保留了我們的探測中的字串作為文本。 在普通的賦值後移除公式不是一個解決方式,因為它讓單元格變成空的。
/goal使代理在這樣的檢查上工作至成功,無須確認的中斷。
/goal Every cleaned workbook the page produces follows docs/price-list-rules.md.
First start the app in the background on http://localhost:5289. Stop it when you finish.
Work through each file in TestData/uploads that expected.csv marks preview or password:
1. Submit it to the /PriceList form, with the password from its expected.csv row if it has one.
2. Take the download link from the response.
3. Save that download as artifacts/cleaned/<file name>.xlsx.
4. Reload it with WorkBook.Load in a small console project under tools/CleanedCheck.
The web project must not compile tools/CleanedCheck.
The console project sets IronXL.License.LicenseKey from IRONXL_LICENSE_KEY.
For every reloaded file, check:
- the two sheet names
- the accepted and rejected counts against expected.csv
- that no cell in either sheet is a formula
- that the PL-2007 description reads back exactly as the supplier typed it
Keep fixing and rechecking until all four files pass. Then put the results in the Walkthrough.
我們的兩個校準清理器在頁面上報告35個接受和6個拒絕的行,因此單靠計數無法區分它們。 那個未改變描述而保存的一個下載在Prices表中有一個HYPERLINK公式。
如何處理密碼保護的工作簿?
一個只有受保護工作表的工作簿可以在未提供任何密碼的情況下打開,如工作表密碼指南所述,我們的受保護工作表測試文件像其他任何文件一樣加載和驗證。 在原地清理工作簿而非建立新工作簿有一個陷阱。 在我們更改加載文件的一個單元格並保存後,<sheetProtection>元素仍存在於工作表XML中,因此這樣生成的清理副本在供應商在Excel中打開它時保持受保護狀態。
一個有開啟密碼的工作簿被加密。 在未使用密碼載入時拋出ArgumentNullException,參數名稱為password,而錯誤或空的密碼會拋出System.Security.SecurityException,提示「無效密碼」,因此上面的匯入器只有在字段包含文本時才傳遞密碼。 使用正確的密碼,WorkBook.Load(stream, password)打開文件,接受文件路徑後的同樣第二個參數,而工作簿密碼指南則說明了這些。
載入的工作簿仍報告其加密狀態,然而從ToByteArray開啟的字節無需密碼。 此頁面的規則要求清理後的文件不帶密碼,因此使用WorkBook.Create生成的新工作簿可以在代碼中保持此規則可見,而不是交給副作用。
何時啟動更多代理?
一個代理可以持有自動化測試,而第二個代理持有瀏覽器證據。
Agent A: add a PriceListImport.Tests xUnit project that the web project doesn't compile.
Add public partial class Program { } to the web project so the tests can reach it.
Use WebApplicationFactory<Program>, and for each workbook in TestData/uploads:
1. Post it to /PriceList as multipart form data.
2. Assert the outcome expected.csv gives for it, sending that row's password where it has one.
3. Download the cleaned workbook, if there is one.
4. Reload that workbook with WorkBook.Load and assert the counts.
5. Assert that no cell holds a formula.
Compare cell values, never file bytes.
Agent B: once Agent A's tests pass, run the app on http://localhost:5289 and open /PriceList.
Use /browser to upload price-list-oversized.xlsx and price-list-encrypted.xlsx.
Record each browser session.
Attach both recordings and a screenshot of each final page to the Walkthrough.
代理B在場是因為內存測試伺服器不應用Kestrel的限制。 我們通過WebApplicationFactory將32.7 MB的工作簿提交給頁面的操作指南版本,該版本無請求限制屬性,測試接收到200狀態和頁面自己的「大於10 MB」消息。 如果後續的更改降低了動作的請求限制,測試持續通過而供應商會遭遇連接錯誤,並只有瀏覽器環境顯示此結果。
在實際運行中,這些提示產生了什麼結果?
七個提示在一個Antigravity CLI會話中對抗一個新的ASP.NET Core MVC應用程式執行。/learn提示在重構和/goal檢查後第六次執行。
- 我們對最終應用的無頭Chrome通過與7個工作簿的預期結果匹配。 改造成符合上傳的頁面預覽了7個中的4個,其中一個是重命名的CSV,並未驗證任何文件。
- 每個清理過的下載重新加載"Prices"和"Rejected"工作表,行數分別為35/6、12/0、15/0和10/0,任何單元格都沒有公式,PL-2007的描述與供應商輸入的完全一致。
- 應用的釋出建構、重新加載檢查和測試專案各自完成時無警告,且xUnit套件7個全部通過。
- 32.7 MB的上傳達到動作並接收應用程序的大小消息,因為快速入門提示將兩個限制屬性設置為64 MB,也將每個表單的多部件主體限制提高到64 MB在
Program.cs。 - 在代理自己的第一次
/browser通過中,所有7行皆通過且沒有代碼變更。 代理使用自己編寫的Puppeteer腳本進行這些上傳和截圖,而由其啟動的Chrome子代理則沒有上傳任何內容。 截圖保存在Antigravity的Artifact文件夾中而非版本庫。 - 重構後,匯入器按照參數名稱捕獲ArgumentNullException,SecurityException和FileLoadException,將LicensingException留給錯誤頁處理。
- 我們的掃描在版本庫檔案、Git物件或Antigravity謄本中未發現任何授權密鑰。
- 一些步驟與頁面上運行的不同。 快速入門提示已經用文字格式寫入說明單元格,因此沒有顯示出校準失敗,而
/goal的重新加載首次檢查中通過。 目標在無頭agy -p中完成,回答結尾有一個目標完成標記。 快速入門計畫及其代碼在同一回合到達,重構提示在計畫截止後直到我們批准才停止。 /learn沒有寫入任何規則文件。它生成了一個帶有trigger: glob的學習提案Artifact,和一個globs值,該值寫為包含三個模式的YAML列表,然後等待批准。- 一個代理完成了兩代理提示的兩部分,且其錄影在同一提交上7個全部通過後被捕捉。 每個測試方法用硬編碼其文件的期望值而非讀取
expected.csv。
Antigravity的版本、模型和時間安排加上測試機在集線器的運行記錄中列出。
疑難排解
- 在ASP.NET MVC中讀取Excel文件從本指南中的控制器和視圖開始
- 在IronXL中應用授權密鑰如果每次上傳結束時為LicensingException
- 設置工作簿密碼以
WorkBook.Load打開加密上傳 - 在.NET中寫入Excel文件演寫入清理後工作簿的
Value和StringValue - IronXL文件大小限制在選擇上傳上限之前
問題?
如果您有任何疑問,請聯繫support@ironsoftware.com
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。