ASP.NET 2.0 後置程式碼 vs 內聯程式碼：架構差異、簡化模型與團隊協作指南

兩種開發模式對比

ASP.NET 2.0 簡化後置程式碼模型

ASP.NET 1.x 需在 .aspx.cs 手動宣告每個控制項變數（protected TextBox TextBox1;），極易遺漏、不同步。ASP.NET 2.0 引入 partial class 機制：

• .aspx 設計器自動產生 .aspx.designer.cs，包含所有控制項欄位宣告。
• .aspx.cs 僅需撰寫事件處理常式與業務邏輯，直接使用控制項 ID 存取。
• @ Page 指令指定 CodeFile="Default.aspx.cs" Inherits="_Default"。

實際程式碼對照

內聯模式

<%@ Page Language="C#" %>
<script runat="server">
    protected void Button1_Click(object sender, EventArgs e)
    {
        Label1.Text = "Hello " + TextBox1.Text;
    }
</script>
<html><body>
    <form runat="server">
        <asp:TextBox ID="TextBox1" runat="server" />
        <asp:Button ID="Button1" Text="Click" OnClick="Button1_Click" runat="server" />
        <asp:Label ID="Label1" runat="server" />
    </form>
</body></html>

後置程式碼模式

Default.aspx

<%@ Page Language="C#" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<html><body>
    <form runat="server">
        <asp:TextBox ID="TextBox1" runat="server" />
        <asp:Button ID="Button1" Text="Click" OnClick="Button1_Click" runat="server" />
        <asp:Label ID="Label1" runat="server" />
    </form>
</body></html>

Default.aspx.cs

public partial class _Default : System.Web.UI.Page
{
    protected void Button1_Click(object sender, EventArgs e)
    {
        Label1.Text = "Hello " + TextBox1.Text; // 直接存取，無需宣告
    }
}

Default.aspx.designer.cs (自動產生，勿手動修改)

public partial class _Default
{
    protected global::System.Web.UI.WebControls.TextBox TextBox1;
    protected global::System.Web.UI.WebControls.Button Button1;
    protected global::System.Web.UI.WebControls.Label Label1;
}

關鍵規則與限制

• Inherits 指定的類別名稱必須與 .aspx.cs 的 partial class 名稱完全一致。
• 事件處理常式存取修飾詞必須為 public、protected、internal，不可為 private（頁面框架需透過反射呼叫）。
• CodeFile 指向原始碼檔；預編譯部署時改用 CodeBehind 指向編譯組件中的類別。
• 單一 .aspx 只能對應一個 CodeFile/CodeBehind。

團隊協作最佳實務

使用 TFS/Git 分支策略 + Code Review，確保 .aspx 與 .aspx.cs 同步演進。

遷移建議：從內聯轉後置程式碼

1. 在 Visual Studio 方案總管右鍵 .aspx → 轉換為 Web 應用程式 或手動建立 .aspx.cs。
2. 將 <script runat="server"> 內容移至 .aspx.cs 對應的 partial class。
3. 刪除 .aspx 中的 <script runat="server"> 區塊。
4. 在 @ Page 加上 CodeFile="..." Inherits="..."。
5. 建置專案，修正編譯錯誤（通常是事件簽章、存取修飾詞）。

結語

ASP.NET 2.0 簡化後置程式碼模型（partial class + 設計器自動產生）徹底解決了 1.x 時代的維護痛點。企業級專案強烈建議採用後置程式碼，配合分層架構、版控策略、自動化建置部署，才能支撐大型團隊長期演進的專案品質。

1. 上一篇文章： ASP.NET 2.0 Web Form 語法完整指南：八大標記元素與程式碼渲染模型
2. 下一篇文章： ASP.NET 2.0 Web 與 HTML 伺服器控制項：從基礎控制項到豐富元件完整解析

關於ASP.NET

多表查詢合併多個 DataTable 為單一結果集

需求：查詢連續 N 天的郵件發送日誌。資料庫按天分表（如 s

.NET 初學者架構設計指南（二）：初識 OO 設計的血淚教訓

前言：一場外包專案引發的設計災難 初次嘗試物件導向（OO）設

Enterprise Library 2.0 - Security Application Block 介紹與配置

Enterprise Library 2.0 中的 Secu

ASP.NET 自訂控件從入門到精通 (3)：狀態管理

3.1 狀態管理 回顧 ASP.NET 頁面生命週期：回發導

ASP.NET 解決文字自動換行問題：Label、Literal、GridView 完整指南 在 global.asax 中實作 URL 重寫 ASP.NET 狀態管理：HiddenField 隱藏欄位 構建 ASP.NET MVC4+EF5+EasyUI+Unity2.x 後台管理系統（11）：系統日誌與例外處理基礎建設 - 資料模型與資料表設計 ASP.NET 伺服器控制項 ViewState 深度解析 ASP.NET 狀態保存完整指南：ViewState、HiddenField、Cookie、QueryString 比較 ASP.NET 2.0 數據教程（三十二）：巢狀資料控制項實作與資料繫結技巧

欄目導航

ASP.NET 基礎

關於ASP.NET

Copyright © 程式碼之家 All Rights Reserved

角色	職責	檔案
UI 設計師	版面配置、CSS、控制項拖曳、屬性設定、資料繫結運算式	.aspx, .css, .master
前端工程師	JavaScript、jQuery、AJAX 呼叫、客戶端驗證、動畫	.js, .aspx (ScriptManager 區塊)
後端開發者	事件處理、資料存取、業務規則、安全性、例外處理	.aspx.cs, .cs (BLL/DAL), .config
資料庫管理員	Schema、預存程序、索引、權限、資料遷移	.sql, .edmx