半岛权威十大直营(官方)网站

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

令人兴奋的是，在3月开初，.NET版Aspose.Words迎来了2020第三次更新！新增了如下四大新功能亮点：

• Xamarin不再需要单独的DLL。
• FindReplaceOptions类扩展了新属性。
• 实现了“ Letterlike”符号的正确呈现。
• 支持在文本框范围内动态拉伸图像，从而为LINQ Reporting Engine保留图像的比例。

>>你可以点击这里下载Aspose.Words for .NET v20.3测试体验

具体更新内容

公共API更改

添加了一个新的公共属性SaveOptions.UpdateLastPrintedProperty

	

		/// <summary>
	

	

		/// Gets or sets a value determining whether the BuiltInDocumentProperties.LastPrinted property is updated before saving.
	

	

		/// </summary>
	

	

		publicboolUpdateLastPrintedProperty
	

用例

Document doc = new Document(docPath);
SaveOptions saveOptions = new PdfSaveOptions();
saveOptions.UpdateLastPrintedProperty = false;
doc.Save(pdfPath, saveOptions);

添加了ImageFieldMergingArgs.Shape属性

客户要求在合并图像合并字段（尤其是WrapType）时控制各种图像属性 。当前，只能 分别使用ImageFieldMergingArgs.ImageWidth 和 ImageFieldMergingArgs.ImageHeight属性设置图像的宽度或高度 。Aspose选择了一种更为通用的方法，并决定对插入的图像（或任何其他形状）提供完全控制。 ImageFieldMergingArgs.Shape 属性如下：

	/// <summary>



	/// Specifies the shape that the mail merge engine must insert into the document.



	/// </summary>



	/// <remarks>



	/// <p>When this property is specified, the mail merge engine ignores all other properties like <see cref="ImageFileName"/> or <see cref="ImageStream"/>



	/// and simply inserts the shape into the document.</p>



	/// <p>Use this property to fully control the process of merging an image merge field.



	/// For example, you can specify <see cref="ShapeBase.WrapType"/> or any other shape property to fine tune the resulting node. However, please note that



	/// you are responsible for providing the content of the shape.</p>



	/// </remarks>



	publicShape Shape {get;set; }


	

如摘要所示，此属性将覆盖其他属性，例如 ImageFileName 或 ImageStream ，即用户只需指定要插入的形状并设置所有必要的属性即可：

private class TestShapeSetFieldMergingCallback : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        //  Implementation is not required.
    }
  
    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        Shape shape = new Shape(args.Document);
        shape.Width = 1000;
        shape.Height = 2000;
        shape.WrapType = WrapType.Square;
  
        string imageFileName = "image.png";
        shape.ImageData.SetImage(imageFileName);
  
        args.Shape = shape;
    }
}

FindReplaceOptions类扩展了新属性

	///
		

	/// Gets or sets a boolean value indicating either to ignore text inside delete revisions.
	

	/// The default value isfalse.
		

	///
	

	publicboolIgnoreDeleted
		

		///
	

		/// Gets or sets a boolean value indicating either to ignore text inside insert revisions.
		

		/// The default value isfalse.
	

		///
		

		publicboolIgnoreInserted
	

		

			///
	

			/// Gets or sets a boolean value indicating either to ignore text inside fields.
		

			/// The default value isfalse.
	

			///
		

			publicboolIgnoreFields
	

		

	

		

	

用例1：说明如何忽略删除修订中的文本

// Create new document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
  
// Insert non-revised text.
builder.Writeln("Deleted");
builder.Write("Text");
  
// Remove first paragraph with tracking revisions.
doc.StartTrackRevisions("author", DateTime.Now);
doc.FirstSection.Body.FirstParagraph.Remove();
doc.StopTrackRevisions();
  
Regex regex = new Regex("e");
FindReplaceOptions options = new FindReplaceOptions();
  
// Replace 'e' in document ignoring deleted text.
options.IgnoreDeleted = true;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: Deleted\rT*xt\f
  
// Replace 'e' in document NOT ignoring deleted text.
options.IgnoreDeleted = false;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: D*l*t*d\rT*xt\f

用例2：说明如何忽略插入修订中的文本

// Create new document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
  
// Insert text with tracking revisions.
doc.StartTrackRevisions("author", DateTime.Now);
builder.Writeln("Inserted");
doc.StopTrackRevisions();
  
// Insert non-revised text.
builder.Write("Text");
  
Regex regex = new Regex("e");
FindReplaceOptions options = new FindReplaceOptions();
  
// Replace 'e' in document ignoring inserted text.
options.IgnoreInserted = true;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: Inserted\rT*xt\f
  
// Replace 'e' in document NOT ignoring inserted text.
options.IgnoreInserted = false;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: Ins*rt*d\rT*xt\f

用例3：说明如何忽略字段内的文本

// Create document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
  
// Insert field with text inside.
builder.InsertField("INCLUDETEXT", "Text in field");
  
Regex regex = new Regex("e");
FindReplaceOptions options = new FindReplaceOptions();
  
// Replace 'e' in document ignoring text inside field.
options.IgnoreFields = true;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: \u0013INCLUDETEXT\u0014Text in field\u0015\f
  
// Replace 'e' in document NOT ignoring text inside field.
options.IgnoreFields = false;
doc.Range.Replace(regex, "*", options);
Console.WriteLine(doc.GetText()); // The output is: \u0013INCLUDETEXT\u0014T*xt in fi*ld\u0015\f

Xamarin不再需要单独的DLL

从Aspose.Words 20.3开始，Xamarin支持已更改。在早期版本中，我们为Xamarin.Android，Xamarin.Mac和Xamarin.iOS提供了单独的DLL。现在Xamarin开发人员可以在所有提到的平台中使用Aspose.Words for .NET Standard。根据.NET Standard文档，用于.NET Standard 2.0的Aspose.Words可以与Xamarin.iOS 10.14或更高版本，Xamarin.Mac 3.8或更高版本以及Xamarin.Android 8.0或更高版本一起使用。