您说得非常正确！传统的 ASP.NET Web Forms 网页（.aspx 文件）确实有两种主要的代码储存模式，这两种模式决定了您的页面逻辑（C# 或 VB.NET 代码）是内联在 .aspx 文件中,还是被分离到单独的文件中。

aspx网页的代码储存模式有两种
（图片来源网络，侵删）

这两种模式是：

  1. 单文件模式
  2. 代码隐藏模式

下面我们来详细解释这两种模式的区别、优缺点以及适用场景。

单文件模式

在单文件模式中，页面的 HTML 标记和服务器端代码（如 C#）都写在同一个 .aspx 文件中。

特点：

  • 文件结构：只有一个文件，Default.aspx。
  • 代码位置：服务器端代码（<script runat="server">...</script> 块）直接嵌入在 HTML 标记之间。
  • 类继承：页面本身就是一个类，它直接继承自 System.Web.UI.Page 或其他基类,您不需要定义一个分部类。

示例代码 (Default.aspx)：

<%@ Page Language="C#" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">单文件模式示例</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:Label ID="lblMessage" runat="server" Text="欢迎访问！"></asp:Label>
            <br />
            <asp:Button ID="btnClick" runat="server" Text="点击我" OnClick="btnClick_Click" />
        </div>
    </form>
    <!-- 服务器端代码直接写在 .aspx 文件中 -->
    <script runat="server">
        // 这是一个页面事件处理方法
        void btnClick_Click(object sender, EventArgs e)
        {
            lblMessage.Text = "按钮被点击了！当前时间: " + DateTime.Now.ToString();
        }
    </script>
</body>
</html>

优点：

  • 简单直观：对于非常简单的页面（如登录页、展示页），所有代码都在一个地方,易于理解。
  • 无需文件切换：开发时不需要在 .aspx 和 .aspx.cs 文件之间来回切换。

缺点：

  • 难以维护：当页面逻辑变得复杂时，HTML 和 C# 代码混杂在一起，可读性会变得很差,难以维护。
  • 团队协作困难：前端开发者和后端开发者无法同时清晰地修改同一个文件。
  • 代码重用性差：页面逻辑与特定页面紧密耦合,无法被其他页面重用。

代码隐藏模式

代码隐藏模式是目前最主流、推荐的模式，它将页面的逻辑代码分离到一个单独的文件中，这个文件通常被称为“代码隐藏文件”（Code-Behind File）。

aspx网页的代码储存模式有两种
（图片来源网络，侵删）

特点：

  • 文件结构：通常包含两个文件：
    • .aspx 文件：只包含 HTML、服务器控件标记和声明。
    • .aspx.cs (C#) 或 .aspx.vb (VB.NET) 文件：包含所有的服务器端逻辑代码。
  • 类继承：代码隐藏文件中定义一个分部类（partial class），这个类继承自 System.Web.UI.Page。.aspx 文件在编译时，会自动生成另一个分部类,两者在编译后合并成一个完整的类。
  • 事件处理：在 .aspx 文件中为控件（如按钮）的事件（如 OnClick）指定一个方法名，在代码隐藏文件中，定义一个具有相同签名（void MyEventHandler(object sender, EventArgs e)）的受保护（protected）或私有（private）方法。

示例代码 (Default.aspx)：

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">代码隐藏模式示例</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:Label ID="lblMessage" runat="server" Text="欢迎访问！"></asp:Label>
            <br />
            <!-- 注意：这里只指定了事件处理方法的名称 -->
            <asp:Button ID="btnClick" runat="server" Text="点击我" OnClick="btnClick_Click" />
        </div>
    </form>
</body>
</html>

示例代码 (Default.aspx.cs)：

using System;
public partial class _Default : System.Web.UI.Page
{
    // 这是一个页面事件处理方法，与 .aspx 文件中的 OnClick 属性对应
    // 必须是 protected 或 private，并且方法签名必须匹配
    protected void btnClick_Click(object sender, EventArgs e)
    {
        // 通过控件的 ID 直接访问它
        lblMessage.Text = "按钮被点击了！当前时间: " + DateTime.Now.ToString();
    }
}

优点：

  • 关注点分离：这是最大的优点，HTML（表示层）和 C# 逻辑（行为层）被清晰地分离开来。
  • 易于维护和调试：代码结构清晰,逻辑错误和界面错误更容易定位。
  • 便于团队协作：前端开发者可以专注于 .aspx 文件，后端开发者可以专注于 .aspx.cs 文件,互不干扰。
  • 代码重用性高：业务逻辑可以封装在类库或基类中,被多个页面共享。

缺点：

  • 文件数量增加：对于一个页面,需要管理两个文件。
  • 对于初学者稍显复杂：需要理解分部类、控件 ID 绑定等概念。

总结与对比

特性 单文件模式 代码隐藏模式
文件数量 1 个 (.aspx) 2 个 (.aspx 和 .aspx.cs)
代码位置 HTML 和 C# 代码在同一个文件中 HTML 和 C# 代码分离在不同文件中
类结构 页面直接继承自 Page 使用 partial class，页面和代码隐藏文件各包含一部分
维护性 差，混杂在一起 优秀，职责分明
团队协作 困难 容易
适用场景 简单的演示页面、快速原型、教学示例 绝大多数生产环境项目、大型应用、需要团队协作的项目
推荐度 不推荐用于实际项目 强烈推荐

虽然两种模式都存在，但代码隐藏模式是现代 ASP.NET Web Forms 开发的标准实践，它遵循了软件工程中“关注点分离”的核心原则，使得代码更健壮、更易于维护和扩展，除非是做一些极其简单的测试,否则都应该优先选择代码隐藏模式。