ASP.NET设置runat="server"的div可见时报内容非字面量错误如何解决

报错根因 #

Cannot get inner content of '' because the contents are not literal报错的核心是：标记了runat="server"的div内部包含非字面量内容，包括内联服务端表达式<%= %>/<%# %>、嵌套服务端控件、动态渲染内容、甚至格式异常的注释，旧版本ASP.NET渲染服务端控件时无法解析这类内容，进而触发异常。

可选解决方案（按遗留系统改造成本从低到高排序） #

方案1（最推荐）：替换Visible控制为CSS display属性控制 #

不需要调整div内部的任何内容，仅修改后端赋值逻辑即可，完全绕过服务端控件的内容解析逻辑：

protected void checkBoxName_CheckedChanged(object sender, EventArgs e)
{
    // 逻辑和原有代码完全一致：复选框未选中时显示div
    testID.Style["display"] = checkBoxName.Checked ? "none" : "block";
}

方案2：纯前端控制显示隐藏 #

直接去掉div的runat="server"属性，通过复选框的前端事件控制可见性，完全不需要修改后端代码：

<!-- 给复选框添加onchange事件 -->
<asp:CheckBox ID="checkBoxName" runat="server" onchange="document.getElementById('testID').style.display = this.checked ? 'none' : 'block'" />
<div id="testID">
  <!-- 原有内容保持不变 -->
</div>

方案3：确需使用Visible属性的适配方案 #

如果必须使用服务端Visible属性控制，可将div内部所有内容移入asp:PlaceHolder控件中，调整结构如下：
前端代码：

<div id="testID" runat="server">
  <asp:PlaceHolder ID="contentHolder" runat="server">
    <!-- 原有全部内容保持不变 -->
  </asp:PlaceHolder>
</div>

后端代码改为控制PlaceHolder的可见性：

protected void checkBoxName_CheckedChanged(object sender, EventArgs e)
{
    contentHolder.Visible = !checkBoxName.Checked;
}

内容的提问来源于stack exchange，提问作者Harold_Finch