文档控件Aspose.Words for .NET 23.3 发行说明

Aspose.Words 是一种高级Word文档处理API，用于执行各种文档管理和操作任务。API支持生成，修改，转换，呈现和打印文档，而无需在跨平台应用程序中直接使用Microsoft Word。此外，

Aspose API支持流行文件格式处理，并允许将各类文档导出或转换为固定布局文件格式和最常用的图像/多媒体格式。

Aspose.words 最新下载（qun：761297826）https://www.evget.com/product/4116/download

主要特点

这个每月定期发布的版本中有 78 项改进和修复。最值得注意的是：

• 用于处理填充颜色的扩展公共属性集。
• 使用适用于 .NET Standard 的 SkiaSharp 本机着色器实现径向渐变渲染。
• 添加了对条形图渲染的 InvertIfNegative 属性的支持。
• 实现了 MOBI 和 AZW3 格式的保存进度通知。
• 添加了指定是否在文档导入时自动调整句子和单词间距的功能。

涵盖此版本中所有更改的完整问题列表

钥匙	概括	类别
WORDSNET-24975	添加确定是否为内联节点和段落分隔符覆盖字体颜色的功能	新功能
WORDSNET-24867	LINQ 报告引擎 - 柱形图不支持负值的不同颜色	新功能
WORDSNET-24960	允许 API 中的 ImportFormatOptions.AdjustSentenceAndWordSpacing 选项	新功能
WORDSNET-24673	提供公共 API 来操作图表网格线	新功能
WORDSNET-24442	添加 Fill.ThemeColor 选项	新功能
WORDSNET-24453	实施插件许可证支持	新功能
WORDSNET-24922	使用适用于 .NET Standard 的 SkiaSharp 本机着色器实现径向渐变渲染	新功能
WORDSNET-24900	保存到 MOBI 时启用 SaveOptions.ProgressCallback	新功能
WORDSNET-24899	保存到 AZW3 时启用 SaveOptions.ProgressCallback	新功能
WORDSNET-24853	使用 XPS 径向渐变画笔将径向渐变渲染到 XPS 中	新功能
WORDSNET-18312	为生成的 AZW3 文档添加导航	新功能
WORDSNET-4769	考虑在导出为 HTML 格式时保留 TOC 格式	新功能
WORDSNET-19867	在 Word 到 HTML 到 Word 的往返过程中保留目录页码	新功能
WORDSNET-24865	不支持的 BMP - 加载 HTML 后不显示图像	强化
WORDSNET-24934	图元文件上的文本呈现不正确	漏洞
WORDSNET-24927	XHTML 到 PDF 的转换问题	漏洞
WORDSNET-24858	渲染后符号重叠	漏洞
WORDSNET-24871	附加数据点呈现在折线图中	漏洞
WORDSNET-24881	更新 STYLEREF 字段时不处理捷克语本地化标题样式名称	漏洞
WORDSNET-24550	使用修订呈现文本后字体大小不正确	漏洞
WORDSNET-24884	转换为 HTML 后文本方向变为垂直	漏洞
WORDSNET-24891	图元文件在 .NET Standard 中呈现不正确	漏洞
WORDSNET-24836	无法打开 PDF 文件	漏洞
WORDSNET-24845	图像在 Aspose.Words 的 .NET Standard 版本中呈现不正确	漏洞
WORDSNET-24857	渲染后符号之间的间距不正确	漏洞
WORDSNET-24674	InsertField 方法在使用 IF 字段时抛出 NullReferenceException	漏洞
WORDSNET-24680	加载加密 DOCX 文档时抛出 FileCorruptedException	漏洞
WORDSNET-24394	渲染希伯来文文档时产生多余的空白页	漏洞
WORDSNET-24947	当段落在 SDT 内时删除段落失败	漏洞
WORDSNET-24561	将 OfficeMath 转换为字符串后性能显着下降	漏洞
WORDSNET-24969	HTML 到 MD：反斜杠附加在结果文件中的图像名称中	漏洞
WORDSNET-24767	包含合并单元格的表格被错误识别	漏洞
WORDSNET-16879	GroupShape 无法以固定文件格式正确呈现	漏洞
WORDSNET-24815	加载 RTF 文档时抛出 FileCorruptedException	漏洞
WORDSNET-24832	不渲染“薄”元素的效果	漏洞
WORDSNET-24988	比较显示错误的文档修订	漏洞
WORDSNET-24957	页脚显示比较文档后的删除修订	漏洞
WORDSNET-25009	加载 DOC 文档时抛出 FileCorruptedException	漏洞
WORDSNET-24754	文档比较删除突出显示的文本	漏洞
WORDSNET-25036	比较文档时抛出 NullReferenceException	漏洞
WORDSNET-25047	调用 UpdatePageLayout 时抛出 ArgumentNullException	漏洞
WORDSNET-25065	加载 DOCX 文档时抛出 FileCorruptedException	漏洞
WORDSNET-23195	保存到 Iso29500_2008_Strict DOCX 后文档中缺少水印图像	漏洞
WORDSNET-24910	Aspose.Words 不包含带编号的空标题段落到目录中	漏洞
WORDSNET-24264	不渲染应用于网格线的效果	漏洞
WORDSNET-24921	内容被下推并与脚注重叠	漏洞
WORDSNET-24928	导入 PDF 文档后颜色反转	漏洞
WORDSNET-24936	Doted 背景呈现在图元文件中	漏洞
WORDSNET-24615	加载 MHTML 时出现 FileCorruptedException	漏洞
WORDSNET-24939	转换 DOCX 时出现 NullReferenceException	漏洞
WORDSNET-23801	未呈现趋势线标签	漏洞
WORDSNET-24061	PDF转换中图片背后的文字	漏洞
WORDSNET-24075	列表项选项卡渲染得比需要的大	漏洞
WORDSNET-23832	渲染后列表制表位不正确	漏洞
WORDSNET-24633	部分 TC 字段在转换为 RTF 后变得可见	漏洞
WORDSNET-24883	允许从公共 API 创建 DML 形状	漏洞
WORDSNET-24952	打开/保存文档后更改形状位置和大小	漏洞
WORDSNET-24954	HTML 到 MD：目录不会导致内容	漏洞
WORDSNET-24658	PdfCompositeEncodingConvertor 抛出 ArgumentOutOfRangeException	漏洞
WORDSNET-24659	在字体回退的情况下，SVG 中的阿拉伯文本呈现不准确	漏洞
WORDSNET-25011	加载文档时出现问题	漏洞
WORDSNET-25013	HTM 加载问题	漏洞
WORDSNET-25027	ReportingEngine，在读取文档中的异步方法时抛出异常	漏洞
WORDSNET-24971	标题中的书签不会保存为 PDF	漏洞
WORDSNET-24970	XML 到 PDF 格式不正确	漏洞
WORDSNET-24489	从 CHM 转换为 DOCX 后清空输出文档	漏洞
WORDSNET-24758	Linux下DOCX保存为图片格式抛出异常	漏洞
WORDSNET-25034	保存文档时抛出 OutOfMemoryException	漏洞
WORDSNET-21353	将 Word 转换为 HTML 到 Word 文档时出现表前样式问题	漏洞
WORDSNET-20994	HTML 到 PDF 的转换生成不正确的输出	漏洞
WORDSNET-24753	通过 DocumentBuilder 插入 HTML 后 UpdatePageLayout 出现 InvalidOperationException	漏洞
WORDSNET-19868	在 Word 到 HTML 到 Word 的往返过程中，表格宽度增加超过页面宽度	漏洞
WORDSNET-20907	对 HtmlOptions.ExportListLabels 选项使用 ExportListLabels.AsInlineText 值会引发 System.InvalidOperationException	漏洞
WORDSNET-11930	将包含位于绝对位置的元素的 html 隐藏到 PDF 中的问题	漏洞
WORDSNET-24485	数学公式中的 delta 字符替换为 V 字符	漏洞
WORDSNET-25050	渲染文档时抛出 NullReferenceException	漏洞
WORDSNET-11936	HTML 中绝对位置的图像元素在 Word 中不显示	漏洞
WORDSNET-24563	Aspose.Word .NET Core 性能问题	漏洞

公共 API 和向后不兼容的更改

本节列出了 Aspose.Words 23.3 中引入的公共 API 更改。它不仅包括新的和过时的公共方法，还包括对 Aspose.Words 幕后行为的任何变化的描述，这些变化可能会影响现有代码。引入的任何可被视为回归并修改现有行为的行为都特别重要，并记录在此处。

添加了用于处理填充颜色的新公共属性

相关问题：WORDSNET-24442

新的公共属性 ForeThemeColor 和 BackThemeColor 已添加到类 Fill。

/// <summary>
/// Gets or sets a ThemeColor object that represents the foreground color for the fill.
/// </summary>
public ThemeColor ForeThemeColor { get; set; }

/// <summary>
/// Gets or sets a ThemeColor object that represents the background color for the fill.
/// </summary>
public ThemeColor BackThemeColor { get; set; }

新的公共属性 ForeTintAndShade 和 BackTintAndShade 已添加到类 Fill。

/// <summary>
/// Gets or sets a double value that lightens or darkens the foreground color.
/// </summary>
/// <remarks>
/// <para> The allowed values are within the range from -1 (the darkest) to 1 (the lightest) for this property.
/// Zero (0) is neutral. Attempting to set this property to a value less than -1 or more than 1
/// results in <see cref="ArgumentOutOfRangeException"/>.</para>
/// </remarks>
public double ForeTintAndShade { get; set; }

/// <summary>
/// Gets or sets a double value that lightens or darkens the background color.
/// </summary>
/// <remarks>
/// <para> The allowed values are within the range from -1 (the darkest) to 1 (the lightest) for this property.
/// Zero (0) is neutral. Attempting to set this property to a value less than -1 or more than 1
/// results in <see cref="ArgumentOutOfRangeException"/>.</para>
/// </remarks>
public double BackTintAndShade { get; set; }

用例：

解释如何使用主题颜色以及色调和阴影。

Document doc = new Document("in.docx");

Fill shapeFill = (doc.GetChild(NodeType.Shape, 0, true) as Shape).Fill;
// Gets and sets the value of theme colors.
if (shapeFill.ForeThemeColor == ThemeColor.Accent1)
shapeFill.ForeThemeColor = ThemeColor.Dark1;

if (shapeFill.BackThemeColor == ThemeColor.Accent2)
shapeFill.BackThemeColor = ThemeColor.Dark2;

Fill textFill1 = doc.FirstSection.Body.FirstParagraph.Runs[0].Font.Fill;
// Gets and sets the tint value.
if (textFill1.ForeTintAndShade == 0)
textFill1.ForeTintAndShade = 0.5;

Fill textFill2 = doc.FirstSection.Body.FirstParagraph.Runs[1].Font.Fill;
// Gets and sets the shade value.
if (textFill2.ForeTintAndShade == 0)
textFill2.ForeTintAndShade = -0.2;

doc.Save("out.docx");

添加公共属性 HasMajorGridlines 和 HasMinorGridlines 到 ChartAxis 类

相关问题：WORDSNET-24673

以下公共属性已添加到 Aspose.Words.Drawing.Charts.ChartAxis 类：

/// <summary>
/// Gets or sets a flag indicating whether the axis has major gridlines.
/// </summary>
public bool HasMajorGridlines { get; set; }

/// <summary>
/// Gets or sets a flag indicating whether the axis has minor gridlines.
/// </summary>
public bool HasMinorGridlines { get; set; }

用例：

解释如何显示图表网格线。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a chart.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

ChartAxis xAxis = shape.Chart.AxisX;
ChartAxis yAxis = shape.Chart.AxisY;

// Show gridlines.
xAxis.HasMajorGridlines = true;
xAxis.HasMinorGridlines = true;
yAxis.HasMajorGridlines = true;
yAxis.HasMinorGridlines = true;

doc.Save("Gridlines.docx");

添加了公共属性 ImportFormatOptions.AdjustSentenceAndWordSpacing

相关问题：WORDSNET-24960

以下公共属性已添加到 Aspose.Words.ImportFormatOptions 类：

/// <summary>
/// Gets or sets a boolean value that specifies whether to adjust sentence and word spacing automatically.
/// The default value is <c>false</c>.
/// </summary>
public bool AdjustSentenceAndWordSpacing { get; set; }

用例：

解释如何使用 AdjustSentenceAndWordSpacing 选项。

Document srcDoc = new Document();
Document dstDoc = new Document();

DocumentBuilder builder = new DocumentBuilder(srcDoc);
builder.Write("Dolor sit amet.");

builder = new DocumentBuilder(dstDoc);
builder.Write("Lorem ipsum.");

ImportFormatOptions options = new ImportFormatOptions() { AdjustSentenceAndWordSpacing = true };
builder.InsertDocument(srcDoc, ImportFormatMode.UseDestinationStyles, options);

Console.WriteLine(dstDoc.FirstSection.Body.FirstParagraph.GetText());

/* This code produces the following output (please note the additional ' ' space character just before pasted content):
Lorem ipsum. Dolor sit amet.
*/

添加了公共属性 TextBox.NoTextRotation

相关问题：WORDSNET-24883

以下公共属性已添加到 Aspose.Words.Drawing.TextBox 类：

/// <summary>
/// Gets or sets a boolean value indicating either text of the TextBox should not rotate when the shape is rotated.
/// </summary>
/// <remarks>
/// <p>The default value is <c>false</c></p>
/// </remarks>
public bool NoTextRotation
 

用例：

说明如何使用 NoTextRotation 选项。

DocumentBuilder builder = new DocumentBuilder();
Shape shape = builder.InsertShape(ShapeType.Ellipse, 20, 20);
shape.TextBox.NoTextRotation = true;

启用 MOBI 和 AZW3 格式的保存进度通知

相关问题：WORDSNET-24900 现在，在保存到 Mobi 或 AZW3 时也会调用 SaveOptions.ProgressCallback。