ASP.NET WebForms中FreeTextBox的<br>标签及编辑异常问题

问题描述 #

• 重复赋值失效：点击按钮将FirstName、LastName等TextBox的值传入FreeTextBox后，后续补充TextBox内容再点击按钮，新值无法传入编辑器，也无法新增TextBox补充输入。比如首次传入John和Smith后，无法补充Jr使内容变为John Jr。
• 换行异常：仅<br>标签可实现换行，但误以为该标签不能包含<或>符号；尝试\n、
等纯文本换行方式均无效，所有文本挤在一行显示。

已尝试操作：

• 在web.config中添加<httpRuntime requestValidationMode="2.0" />
• 替换为TinyMCE、CKEditor、Ajax HTML Editor Extender等编辑器，问题未解决甚至更严重

问题原因分析 #

1. 重复赋值失效原因 #

当前代码每次点击按钮都会直接覆盖FreeTextBox内容，且冗余使用Session存储值——Session可能残留旧值，直接读取TextBox的Text属性即可获取最新输入。此外WebForms视图状态配置不当，会导致TextBox新值未正确回传，或FreeTextBox内容被旧视图状态覆盖。

2. 换行问题原因 #

FreeTextBox作为富文本编辑器，Text属性仅识别HTML格式内容。\n、
是纯文本换行符，在HTML中不会被解析为换行；你对<br>标签的误解，大概率是因为配置开启了HTML编码，导致标签被转义为<br>纯文本，从而失去换行功能。

解决方案 #

解决重复赋值失效 #

1. 优化按钮事件代码：移除冗余Session，直接读取TextBox最新值，按需替换或追加内容：

protected void pass_Click(object sender, EventArgs e)
{
    string text = "The name and the surname are";
    string firstName = fName.Text.Trim();
    string lastName = lName.Text.Trim();
    // 替换原有内容直接赋值，追加内容则用 FreeTextBox1.Text += 新内容
    FreeTextBox1.Text = $"{text}<br>{firstName}<br>{lastName}<br>";
}

2. 检查视图状态配置：确保FreeTextBox的EnableViewState="true"（默认开启），且页面未禁用视图状态——视图状态禁用会导致控件内容无法正确回传。
3. 排查JS干扰：检查页面是否存在阻止按钮回发、或修改TextBox值导致回传数据丢失的JavaScript代码。

解决换行问题 #

1. 使用HTML换行标签：直接用<br>或<p>标签实现换行，FreeTextBox支持HTML格式，只要标签未被转义即可生效。
2. 关闭HTML编码：在FreeTextBox控件中设置EncodeHtml="false"，避免标签被转义为纯文本：

<FTB:FreeTextBox ID="FreeTextBox1" runat="server" EncodeHtml="false"></FTB:FreeTextBox>

3. 纯文本转HTML换行：若需插入带换行的纯文本，将\n替换为<br>：

string plainText = "第一行\n第二行";
FreeTextBox1.Text = plainText.Replace("\n", "<br>");

替代富文本编辑器推荐 #

• CKEditor 4/5：成熟稳定，有适配WebForms的版本，文档完善、配置灵活，能完美处理HTML格式和内容回传问题。
• TinyMCE：轻量易用，官方提供.NET集成包，快速上手，换行和回传逻辑可靠。
• DevExpress ASPxHtmlEditor：若项目使用DevExpress控件集，该编辑器集成度高、功能强大，适合企业级场景。

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