萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

IIS 7 下 Ajax.AjaxMethod 無效解決:Handlers 正確註冊指南

問題現象

ASP.NET 開發伺服器 (Cassini) 正常運作的 Ajax.AjaxMethod,部署至 IIS 7 後 JavaScript 呼叫失敗,錯誤:找不到 CS 類別/方法。

根本原因

IIS 7 採用整合管線模式,HTTP 處理器註冊必須在 <system.webServer><handlers> 區段,而非舊版 <system.web><httpHandlers>。

完整 Web.config 配置

<configuration>
  <system.web>
    <httpHandlers>
      <add verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" />
    </httpHandlers>
  </system.web>

  <system.webServer>
    <handlers>
      <add name="AjaxMethod" verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" preCondition="integratedMode" />
    </handlers>
  </system.webServer>
</configuration>

後端 C# 程式碼規範

using Ajax;

public partial class MyPage : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        // 必須註冊類別供 Ajax 代理呼叫
        Ajax.Utility.RegisterTypeForAjax(typeof(MyPage)); // 或獨立類別名稱
    }

    [Ajax.AjaxMethod()] // 或 [Ajax.AjaxMethod(HttpSessionStateRequirement.Read)]
    public string GetAddress(string UserID)
    {
        string Address = "";
        // 業務邏輯查詢地址
        return Address;
    }
}

前端 JavaScript 呼叫

<script src="ajax/MyPage.ashx" type="text/javascript"></script>
<script type="text/javascript">
    var addr = MyPage.GetAddress('123').value;  // 類別名.方法名
</script>

必要條件檢查清單

  1. 專案參考 Ajax.dll (右鍵專案 → 加入參考 → 瀏覽選取)。
  2. web.config 同時包含 system.web/httpHandlers (相容) 與 system.webServer/handlers (IIS 7+ 整合模式)。
  3. 頁面含 <form runat="server"></form>。
  4. 方法為 public,標記 [Ajax.AjaxMethod()]。
  5. 需使用 Session 時:[Ajax.AjaxMethod(HttpSessionStateRequirement.Read)]。
  6. IIS 應用程式集區設為 Integrated 管線模式,.NET 版本正確 (v2.0/v4.0)。

常見坑點

  • 僅設定 system.web/httpHandlers → IIS 7 整合模式不生效。
  • type 寫錯:需 完整類別名, 組件名稱 (如 Ajax.PageHandlerFactory, Ajax),組件名不含副檔名。
  • 未註冊 RegisterTypeForAjax → JS 端找不到類別代理。
  • 方法非 public → JS 呼叫提示「不支援此屬性或方法」。
copyright © 萬盛學電腦網 all rights reserved