這不是某一家產品的官方手冊複本。它把 2026 年 10 月還能公開讀到的資料,整理成一條可以跟著做的學習路徑。

主線是 Elanat 的 WebForms Core:伺服器上的 類別寫出 Action Control,瀏覽器裡的 WebFormsJS 照著改 HTML。在 .NET 上,最完整的載體是 CodeBehind;同一套類別也能放進 Razor Pages,或只搭配一個靜態 HTML。

同名的另外兩條路放在最後兩章,而且會先講清楚它們不是同一件事:

  • WebFormsForCore:把 .NET Framework 的 / Web Forms 移植到 .NET 10,讓舊的 繼續跑,包含 Linux。

  • WebFormsCore:另一個以 Web Forms 為靈感、針對 ASP.NET Core 10 重寫的頁面框架,公開 README 仍在早期。

你如果寫過 ASP.NET Web Forms,會覺得名詞很熟:頁面、回傳、控制項、Code-Behind。熟的是感覺,不是實作。WebForms Core 沒有 ,也不把整頁重新畫出來。伺服器只回一小段文字,告訴瀏覽器「把這個標籤的字改掉、把那個按鈕關掉」。

讀完第 1 章以前,先記住一句話:WebForms Core 是一套通訊協定,加上兩邊的實作。一邊是任何語言都能寫的 類別,一邊是瀏覽器裡的 。C# 是這套類別的母本,所以這本手冊以 .NET 為主。

建議順序

  1. 第 1–2 章先把名字和歷史放對位置。跳過這兩章,後面的 會和舊版 Web Forms 的 PostBack 纏在一起。

  2. 第 3–5 章把一條請求走完:點按鈕、表單怎麼送、伺服器回什麼、畫面哪裡變。

  3. 第 6–8 章是工具箱:怎麼指到正確的標籤、一行 Action Control 怎麼讀、C# 方法怎麼對上那一行。

  4. 第 9–11 章拿來做:一般欄位、檔案、延遲刪除、瀏覽器上一頁,最後做一頁聯絡表單。

  5. 第 12 章才看「把舊專案搬上 .NET」和另一個同名框架。那是遷移手冊,不是這條主線的前置知識。

版本與界線

公開頁面會改。這本手冊鎖定下面這些可以核對的來源,不把部落格裡的行銷句當成 API。

@lY@ 項目 & 這本手冊採用的依據
CodeBehind & NuGet 4.8.1,目標框架 ,頁面上的 與 MVC 範例
WebForms Core 教學 & Elanat 文件〈Using WebForms Core in CodeBehind Framework〉
Action Control & 的 README:代碼表、定位語法、、多重回應
類別方法 & CodeBehind 教學裡出現的 C# 呼叫,並以各語言類別的母本行為交叉對照
WebFormsForCore & 官方站 2026-10 的移植步驟,套件版本

Go 語言移植的 簽章,和 CodeBehind 教學裡的單參數呼叫不完全一樣。手冊遇到這種落差會寫出來,不會假裝只有一種多載。你專案裡的 IntelliSense 優先於這本書。

程式範例刻意只用 ASCII。中文解釋放在程式外面,這樣用 XeLaTeX 排版時,程式字體不必承擔中日韓字形。你自己的頁面當然可以用中文標籤與中文訊息。