以傳統 ASP.NET WebForms (`.aspx`) 搭配 jQuery `$.ajax` 實作無重整登入,展示前端表單驗證、後端驗證邏輯、JSON 回應、錯誤處理與安全性考量 (防 CSRF、密碼雜湊)。本文提供可直接執行的最小化完整範例。
/Login.aspx 前端頁面
/Login.aspx.cs 後端處理 (PageMethod / WebMethod)
/Services/AuthService.asmx 獨立 Web Service (替代方案)
/App_Code/DAL.cs 資料存取層
/App_Code/BLL.cs 業務邏輯層
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Login.aspx.cs" Inherits="Demo.Login" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>AJAX 登入示範</title>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<style>
.field { margin: 8px 0; }
.error { color: red; }
.success { color: green; }
</style>
</head>
<body>
<h2>使用者登入</h2>
<div class="field">
<label>帳號:</label>
<input type="text" id="txtUser" autocomplete="username" />
</div>
<div class="field">
<label>密碼:</label>
<input type="password" id="txtPwd" autocomplete="current-password" />
</div>
<button id="btnLogin" type="button">登入</button>
<button id="btnClear" type="button">清空</button>
<span id="msg" class="error"></span>
<script>
$(function() {
$("#btnClear").click(() => { $("#txtUser, #txtPwd").val(""); $("#msg").text(""); });
$("#btnLogin").click(function() {
var $btn = $(this).prop("disabled", true);
var user = $("#txtUser").val().trim();
var pwd = $("#txtPwd").val();
if (!user || !pwd) {
$("#msg").text("請輸入帳號密碼");
$btn.prop("disabled", false);
return;
}
$.ajax({
url: "Login.aspx/DoLogin", // PageMethod
type: "POST",
contentType: "application/json; charset=utf-8",
dataType: "json",
data: JSON.stringify({ username: user, password: pwd }),
success: function(resp) {
var result = resp.d; // ASP.NET PageMethod 包裝層
if (result.Success) {
$("#msg").removeClass("error").addClass("success").text(result.Message);
setTimeout(() => location.href = "Default.aspx", 800);
} else {
$("#msg").removeClass("success").addClass("error").text(result.Message);
}
},
error: function(xhr) {
$("#msg").text("系統錯誤:" + xhr.statusText);
},
complete: function() { $btn.prop("disabled", false); }
});
});
});
</script>
</body>
</html>
[System.Web.Services.WebMethod]
public static LoginResult DoLogin(string username, string password) {
try {
// 1. 輸入驗證
if (string.IsNullOrWhiteSpace(username) || string.IsNullOrWhiteSpace(password))
return new LoginResult { Success = false, Message = "參數不可為空" };
// 2. 呼叫 BLL 驗證 (此處示範直接查詢)
var bll = new BLL();
bool valid = bll.ValidateUser(username, password);
// 3. 登入成功:建立 FormsAuthentication Ticket
if (valid) {
FormsAuthentication.SetAuthCookie(username, false); // 持久化由表單決定
return new LoginResult { Success = true, Message = "登入成功" };
}
return new LoginResult { Success = false, Message = "帳號或密碼錯誤" };
} catch (Exception ex) {
// 記錄完整堆疊至 Log,前端只回通用訊息
Log.Error(ex, "登入異常");
return new LoginResult { Success = false, Message = "系統忙碌中,請稍後再試" };
}
}
public class LoginResult {
public bool Success { get; set; }
public string Message { get; set; }
}
// DAL.cs
public class UserDAL {
readonly string _connStr = ConfigurationManager.ConnectionStrings["Default"].ConnectionString;
public UserDto GetByUsername(string username) {
const string sql = "SELECT UserId, Username, PasswordHash, Salt FROM Users WHERE Username=@u";
using (var conn = new SqlConnection(_connStr))
using (var cmd = new SqlCommand(sql, conn)) {
cmd.Parameters.AddWithValue("@u", username);
conn.Open();
using (var rd = cmd.ExecuteReader()) {
if (rd.Read()) return new UserDto {
UserId = rd.GetInt32(0),
Username = rd.GetString(1),
PasswordHash = rd.GetString(2),
Salt = rd.GetString(3)
};
}
}
return null;
}
}
// BLL.cs
public class BLL {
private readonly UserDAL _dal = new UserDAL();
public bool ValidateUser(string username, string password) {
var user = _dal.GetByUsername(username);
if (user == null) return false;
// 驗證密碼雜湊 (PBKDF2/BCrypt/Argon2)
return PasswordHasher.Verify(password, user.PasswordHash, user.Salt);
}
}
若不想用 PageMethod,可建立 `AuthService.asmx`:
[WebService(Namespace = "https://tempuri.org/")]
[ScriptService] // 允許 JSON 呼叫
public class AuthService : WebService {
[WebMethod(EnableSession = true)]
public LoginResult Login(string username, string password) { /* 同 DoLogin 邏輯 */ }
}
前端 URL 改為 `"AuthService.asmx/Login"`,其餘相同。
此架構清晰分離關注點,易於單元測試 (BLL/DAL 可 Mock),並可平滑遷移至 ASP.NET Core / Web API。