萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 調用 WebService 實現郵箱異步驗證(ASP.NET 示例)

架構概覽

前端:jQuery + ScriptManager 代理調用 ASMX WebService。
後端:C# WebMethod 返回 JSON 字符串,判斷郵箱是否存在。

前端完整代碼

<%@ Page Language="C#" %>
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>郵箱異步驗證</title>
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
</head>
<body>
  <form id="form1" runat="server">
    <asp:ScriptManager ID="ScriptManager1" runat="server">
      <Services>
        <asp:ServiceReference Path="~/WebService1.asmx" />
      </Services>
    </asp:ScriptManager>
    
    <div>
      <label>郵箱:<input type="email" id="txtUsername" /></label>
      <span id="emailMsg" style="margin-left:10px;color:red;"></span>
    </div>
  </form>

  <script>
    $(function() {
      $('#txtUsername').on('blur', function() {
        var email = $.trim($(this).val());
        if (!email) return;
        
        // 顯示檢查中
        $('#emailMsg').text('驗證中...').css('color', '#999');
        
        // 調用 WebService(ScriptManager 生成的代理類)
        // 命名空間.類名.方法名(參數, 成功回調, 失敗回調)
        SinaWeiBo.WebService1.cunzai(email, 
          function(result) { // 成功回調
            if (result === "該郵箱已存在請重新輸入") {
              $('#emailMsg').text(result).css('color', 'red');
              $(this).val('').focus(); // 清空並聚焦
            } else {
              $('#emailMsg').text('可以使用').css('color', 'green');
            }
          }.bind(this), // 綁定 this 為 input 元素
          function(error) { // 失敗回調
            $('#emailMsg').text('驗證失敗:' + error.get_message()).css('color', 'red');
          }
        );
      });
    });
  </script>
</body>
</html>

後端 WebService (WebService1.asmx.cs)

using System;
using System.Web.Services;
using System.Data;

namespace SinaWeiBo
{
  [WebService(Namespace = "https://tempuri.org/")]
  [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
  [System.Web.Script.Services.ScriptService] // 關鍵:允許腳本調用
  public class WebService1 : System.Web.Services.WebService
  {
    [WebMethod]
    public string cunzai(string txtusername)
    {
      try
      {
        // 假設 BLL 層查詢
        // BLL.T_Users bt1 = new BLL.T_Users();
        // DataSet ds = bt1.GetList("T_UserEmail='" + txtusername + "'");
        // 模擬數據
        var existingEmails = new[] { "test@test.com", "admin@example.com" };
        
        if (Array.Exists(existingEmails, e => e.Equals(txtusername, StringComparison.OrdinalIgnoreCase))) {
          return "該郵箱已存在請重新輸入";
        }
        return "正確"; // 或返回 "可以使用"
      }
      catch (Exception ex)
      {
        // 記錄日誌
        return "服務器錯誤:" + ex.Message;
      }
    }
  }
}

關鍵點詳解

  1. [ScriptService] 屬性:必須標記在 WebService 類上,才會生成 JS 代理類(`SinaWeiBo.WebService1`)。
  2. ScriptManager 配置:`` 引入服務,自動生成 JS 代理。
  3. 代理調用簽名:`Namespace.Class.Method(params, onSuccess, onFailed, userContext)`。成功回調第一參數為返回值(已自動反序列化)。
  4. 參數傳遞:JS 對象屬性名需與 WebMethod 參數名一致(區分大小寫)。
  5. 錯誤處理:失敗回調參數為 `Error` 對象,含 `get_message()`、`get_stackTrace()`。

現代替代方案(推薦)

ASMX 屬於舊技術棧。新項目建議使用:

  • ASP.NET Core Web API + `fetch`/`axios`:RESTful、跨平台、高性能。
  • ASP.NET MVC/WebAPI Controller 返回 `JsonResult`。
  • 前端驗證庫:如 `jquery-validation` + `remote` 規則,聲明式調用後端 API。

安全提示

  • 後端**必須**參數化查詢(如 `WHERE Email = @Email`),防止 SQL 注入。示例中字符串拼接極其危險。
  • 生產環境應添加防刷機制(限流、驗證碼)。
  • 郵箱存在性檢洩露用戶信息,建議統一返回「如果郵箱存在,發送重置郵件」模式,不直接告知存在與否。

結語

ScriptManager + ASMX 是 ASP.NET WebForms 時代的產物,理解其原理有助於維護老項目。新開發請毫不猶豫選擇 Web API + 現代前端工具鏈。

copyright © 萬盛學電腦網 all rights reserved