在 ASP.NET Web Forms 裡,伺服器控制項最終渲染到 HTML 時,ID 常常會被加上命名容器的前綴(例如 ctl00_ContentPlaceHolder1_TextBox1)。如果直接在 JavaScript 裡寫 document.getElementById("TextBox1"),就會找不到元素。標準解法是透過 ClientID 屬性把真正的 ID 輸出到客戶端腳本中。
<%@ Page Language="VB" AutoEventWireup="false" CodeFile="Default.aspx.vb" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<%--
<script type="text/javascript">
function E() {
var ary = document.getElementById("<%=TextBox1.ClientID %>");
var b = ary.tagName;
alert(ary + "" + b);
}
</script>
--%>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Button runat="server" ID="btn" Text="asd" />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<input type="button" onclick="E();" value="ssss" />
</div>
</form>
</body>
</html>
var ary = document.getElementById("<%=TextBox1.ClientID %>");
<%= %> 是 ASP.NET 的輸出運算式,會在伺服器端執行並把結果寫進頁面。因此 TextBox1.ClientID 會在頁面送到瀏覽器之前,就被替換成該控制項實際渲染出來的 id 字串。這樣 JavaScript 拿到的就是正確的目標,不必去猜前綴長什麼樣。
ClientIDMode="Static"(.NET 4.0 以上),可讓伺服器控制項輸出固定不變的 ID,前端就能直接寫死。CssClass 設定樣式類別,前端改用 querySelector 定位,避開 ID 變動問題。Page.ClientScript.RegisterClientScriptBlock 動態輸出參數,適合需要傳遞大量伺服器資料的情況。這三種方式裡,<%= Control.ClientID %> 是最直覺、改動最小的做法;如果是新專案,優先考慮 ClientIDMode="Static" 會讓前後端分工更清楚。