针对Telerik UI for WinForms的每个版本，技术团队都尽量避免引入影响公共 API 的更改。但是有时需要进行此类更改才能使产品发展，这可能会导致应用程序升级到最新的 Telerik 版本时出现问题，这时就需要Telerik升级API Analyzer，其目的是通过比较两个版本并确定有问题的区域，使您的升级过程更容易。Telerik UI for WinForm R3 2021 SP1最新版

Telerik Upgrade API Analyzer可用于升级桌面应用程序（如 WPF 或 WinForms）以及 Silverlight 或 ASP.NET Web 应用程序。

Telerik Upgrade API Analyzer目前支持从 R1 2015 到当前的Telerik 版本，可以根据要求添加其他版本。

注意：如果您收到一条消息说找不到 DataFlow 程序集，您可能需要安装 Microsoft build tools。

为什么需要这个工具？

Telerik Upgrade API Analyzer 工具将帮助您将 Telerik 控件升级到更新版本，它会彻底分析您的项目代码，并提供在当前使用的版本和您计划升级到的版本之间发现的更改列表。 此类更改可能包括过时和删除的方法和属性，以及修改后的方法和属性。 此外，该工具会指出受特定更改影响的确切代码段，并且在涉及过时方法/属性的情况下，该工具会提供有关如何修改该代码的建议。

注意：在此开发阶段，Telerik Upgrade API Analyzer 仅检查应用程序的 C# 代码。

从哪里获得Telerik Upgrade API Analyzer？

Telerik Upgrade API Analyzer是一个 ClickOnce 应用程序，您可以直接从站点下载安装文件。

注意：该工具依赖于 Microsoft .NET Framework 4.5.2，如果您的机器上没有该框架，该工具的设置会自动安装它。

如何使用该工具？

运行 Telerik Upgrade API Analyzer 会打开图 1 所示的屏幕。

图 1：Telerik Upgrade API Analyzer 的初始屏幕

您需要做的就是：

1. 选择平台。
2. 选择您正在使用的 Telerik 程序集的当前版本。
3. 选择您要升级到的版本。这三个组合框会根据您的选择即时填充，因此您应该连续选择所需的值。
4. 打开您计划升级的解决方案。

注意：您还可以通过单击Compatibility按钮从升级项目向导运行Telerik Upgrade API Analyzer。在这种情况下，该工具将打开，其中包含向导中指出的技术、您的版本和升级版本参数。 当 Upgrade API Analyzer 直接通过 Compatibility 按钮启动而不先安装工具时，安装会自动开始。 如果您的计算机上不存在 .NET Framework 4.5.2，应用程序会在安装结束时提示您手动安装。

图 2：升级项目向导中的Compatibility按钮

该工具开始分析代码，如图 3 所示，并列出在两个版本之间发现的所有更改，如图 4 所示。

图 3：一旦您打开解决方案，该工具就会开始分析

图 4：Upgrade API Analyzer列表发现的差异

Upgrade API Analyzer以方便的方式提供了两个版本之间发现差异的详细列表，以供查看。 该工具使用 RadGridView for WPF 来呈现结果，因此您可以从其排序、过滤和调整列大小等功能中受益。

对于每个更改，您可以看到以下信息：

• Difference：它可以是过时的、删除的和修改的。

默认情况下，Modified更改不会显示，因为它们实际上表明方法/类中存在内部更改，这不会影响其整体功能，也不需要您进行任何操作。 尽管如此，您仍然可以通过更新差异列的过滤器来看到修改的更改，如图 5 所示。

图 5：显示找到的所有更改，包括已修改的更改

• Kind：可以是类型、属性、方法和字段。
• Node：类型/属性/方法/字段的名称。
• Assembly：发现更改的程序集。
• Message：呈现一种“现在做什么？” 信息；提供关于应该对具体更改采取什么操作以使升级完美无缺的附加信息。
• Project：更改所在的项目。
• Source：项目中发现更改的文件。
• Line：源文件中的确切行。
• Character：先前设置的行中的字符。

此外，Upgrade API Analyzer 提供了通过右上角的Export按钮保存收集到的信息以供稍后使用的选项，如图 6 所示。数据将被排列并导出到 HTML 文档，导出的信息包括网格中当前可见（已过滤）的数据。

图 6：API Analyzer提供到HTML文档的导出

Telerik UI for WinForms| 下载试用

Telerik UI for WinForms拥有适用Windows Forms的110多个令人惊叹的UI控件。所有的UI for WinForms控件都具有完整的主题支持，可以轻松地帮助开发人员在桌面和平板电脑应用程序提供一致美观的下一代用户体验。

更多产品正版授权详情及优惠，欢迎咨询在线客服>>

了解最新Kendo UI最新资讯，请关注Telerik中文网！