当我们发布新的 Service Pack 时，我们会对应用程序中可能包含的许多组件中的已知问题提供修复。本升级指南提供了重要信息，可帮助您将 Web 应用程序升级到新的 Service Pack 版本。

新的 Service Pack 包含对大量组件的错误修复和小更新，这些组件可能是网络应用程序的一部分。强烈建议您将应用程序更新到最新版本。

TX Text Control .NET Server for ASP.NET 提供了许多不同的库、服务和组件，当新的 Service Pack 发布时，需要对它们进行更新。本教程展示了如何更新使用文档编辑器、文档查看器和关键库（如 ServerTextControl 和 MailMerge .NET Server）的 ASP.NET Web 应用程序。

安装 Service Pack

第一步是下载并安装 Service Pack 设置。我们已将完整版和 Service Pack 安装程序合并为一个统一的安装程序。该安装程序会自动检测是使用 Service Pack 文件修补已安装的版本，还是安装新版本。

有两种不同的方式可以下载新的完整版安装程序。

1、如果你有访问门户网站的权限（账户所有者），你可以登录到你的 Text Control 账户并从那里下载设置。

文本控制许可证管理门户

2、如果您是指定的开发人员，您应该已经收到一封带有下载链接的电子邮件，该链接可用于下载完整版三次。

如果您没有收到电子邮件，请联系账户所有者或我们的支持团队寻求帮助。

下载新的完整版安装程序后，请运行安装程序并按照说明使用最新的 Service Pack 文件修补已安装的版本。

检查文件版本

您可以检查文件版本，以确保您安装了正确的 Service Pack 版本。所有程序集的文件版本都有相同的模式。以下示例显示了核心程序集 TXTextControl.dll 的文件版本。

32.0.2503.500

31.0.2404.500

所有 TX Text Control 程序集（TXTextControl.Web 和 TXTextControl.Web.MVC.DocumentViewer NuGet 包中的程序集除外）的程序集版本在 Service Pack 后不会更改。这样就可以轻松更换所有程序集。

更新策略

以下方案说明了如何升级 Web 应用程序以及如何升级其他所需组件，例如文档编辑器所需的 TCP 同步服务。

更新 NuGet 软件包

对于 .NET Framework 和 .NET 应用程序（.NET Framework 4.8、.NET 5、6 和 7），从 Text Control Offline Packages 源将使用的 Text Control NuGet 包更新到最新的稳定版本：

.NET框架在使用补丁版本测试应用程序后，您可以按照我们文档中的说明部署应用程序。

更新 TCP 服务

在大多数情况下，TCP 同步服务已经部署，并与当前版本的 TX Text Control 一起运行。由于打补丁版本也监听相同的 TCP 端口，您只需替换可重新发布的文件即可。

1、在安装了 TCP 服务的服务器上，打开 Windows 服务应用程序，找到 TX TextControl 32.0 服务，然后选择 "停止 "以暂时停止该服务。

作为替代方法，您可以使用以下 PowerShell 命令：

Stop-Service -Name "TX TextControl 32.0 Service" -Force

2、用安装文件夹中的补丁版本替换所有分发的文件（默认情况下：C:\Program Files\Text Control GmbH\TX Text Control 32.0.NET Server for ASP.NET\Assembly 和 C:\Program Files\Text Control GmbH\TX Text Control 32.0.NET Server for ASP.NET/Assembly/bin64）。根据您要部署的组件，该文件夹应与此截图相似：

如果您使用的是 .NET Framework，则无需明确更新引用的程序集。它们具有相同的程序集版本，并指向替换新文件的安装文件夹。

主动连接

如果存在活动连接且 TCP 服务仍在运行，请在任务管理器中停止 TX 文本控制服务任务。

3、单击 "开始"，在 Windows 服务应用程序中重新启动服务。

或者，您也可以使用以下 PowerShell 命令：

Start-Service -Name "TX TextControl 32.0 Service"

关于 ASP.NET

第一个真正的所见即所得、基于 HTML5 的网络编辑器和报表模板设计器。为您的用户提供一个与 MS Word 兼容的编辑器，让他们可以在任何地方--任何设备上的任何浏览器中--创建功能强大的报表模板。我们的 ASP.NET 组件将强大的报表工具和易用的所见即所得文字处理器结合在一起，完全可编程并嵌入到您的 ASP.NET 应用程序中。