ASP.NET 升級 3.5 後「服務器標記 asp:ScriptManager 不明確」衝突徹底解決方案

故障背景

舊項目從 .NET Framework 2.0 升級至 3.5，原安裝 Microsoft ASP.NET 2.0 AJAX Extensions。升級後出現兩類衝突：

1. 基類字段類型不兼容：基類包括字段 "ScriptManager1"，但其類型 (System.Web.UI.ScriptManager) 與控件 (System.Web.UI.ScriptManager) 的類型不兼容
2. 服務器標記不明確：服務器標記 "asp:ScriptManager" 不明確。請修改導致此多義性的關聯注冊並選取新的標記前綴

根因分析

.NET 3.5 將 AJAX 內建為核心程序集 System.Web.Extensions 3.5.0.0，而舊項目引用 1.0 版本 System.Web.Extensions 1.0.61025.0。兩版本同時存在於 GAC/應用程序域，導致類型標識衝突（同名稱、同命名空間、不同版本）。

徹底解決方案：全量版本號替換

第一步：頁面指令註冊替換

<%@ Register Assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
    Namespace="System.Web.UI" TagPrefix="asp" %>


<%@ Register Assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
    Namespace="System.Web.UI" TagPrefix="asp" %>

第二步：Web.config 完整版本號替換

使用編輯器全局搜索替換：Version=1.0.61025.0 → Version=3.5.0.0，涵蓋以下所有節點：

1. configSections 區塊

2. system.web/pages/controls 區塊

3. system.web/compilation/assemblies 區塊

4. system.web/httpHandlers 區塊

5. system.web/httpModules 區塊

6. system.webServer/validation/modules/handlers 區塊 (IIS 7+ 集成模式)

7. system.web.extensions/scripting 區塊

第三步：清理解決方案引用

1. Visual Studio → 解決方案資源管理器 → 引用
2. 移除 System.Web.Extensions (v1.0) 引用
3. 添加引用 → .NET 組件 → System.Web.Extensions (v3.5.0.0)
4. 確保 Copy Local = False（GAC 中已存在）

第四步：清理臨時文件並重啟

# 清理 ASP.NET 臨時編譯文件
del /s /q "C:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\*"
del /s /q "C:\Windows\Microsoft.NET\Framework64\v2.0.50727\Temporary ASP.NET Files\*"

# 重啟 IIS
iisreset /restart

驗證修復

1. 瀏覽器訪問含 ScriptManager 頁面，無「不明確」錯誤
2. AJAX 功能正常：UpdatePanel 部分刷新、PageMethods 調用、ScriptService 呼叫
3. 事件查看器 → Application → 無新增 HttpCompileException 或 AmbiguousMatchException

避坑指南

總結

.NET 2.0 → 3.5 升級導致 System.Web.Extensions 版本衝突。核心解法：Web.config 及頁面指令中所有 Version=1.0.61025.0 全量替換為 Version=3.5.0.0，清理 Bin 目錄舊 DLL 與臨時編譯緩存，重啟 IIS。徹底消除雙版本共存引發的類型標識模糊。