.NET WebForm网站迁移至Web应用后document.frmName未定义问题排查

1. 非标准DOM访问方式的兼容性失效 #

document.frmGrid这种写法属于浏览器历史遗留的非标准兼容行为——早年部分浏览器会自动把带name属性的表单、控件挂载成document的全局属性，方便快速访问。但现在主流浏览器在严格模式（比如HTML5 DOCTYPE下）会禁用这种行为，避免全局命名冲突。

升级到.NET 4.8后，ASP.NET默认会输出标准的HTML5 DOCTYPE，而你之前的4.5项目可能用的是宽松的过渡DOCTYPE，浏览器在严格模式下就不再支持document.<表单名>这种非标准写法了。

2. Web Site转Web Application的配置差异 #

从传统Web Site改成Web Application项目时，默认配置有不少变化：

• Web Application项目的ClientIDMode默认是Predictable，虽然主要影响控件ID，但连带会让表单name属性的渲染逻辑更严谨，间接导致浏览器的非标准挂载逻辑失效。
• 两种项目的页面编译机制不同，可能让表单在DOM中的渲染顺序、结构出现细微变化，进一步让非标准访问方式无法生效。

3. 标准API与非标准写法的本质区别 #

document.forms.frmGrid是W3C规范的标准写法，document.forms是专门用来获取页面表单集合的API，通过表单name访问是合规用法。而document.frmGrid全靠浏览器兼容，一旦环境（框架升级、项目类型变更、浏览器行为调整）变了，必然会报错。

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