六月已至，.NET版Aspose.Words也為大家?guī)砹?月的新版本！Aspose.Words for .Net是一種高級Word文檔處理API，用于執(zhí)行各種文檔管理和操作任務(wù)。API支持生成，修改，轉(zhuǎn)換，呈現(xiàn)和打印文檔，而無需在跨平臺應(yīng)用程序中直接使用Microsoft Word。

主要特點如下：

• Font.EmphasisMark向公眾公開
• 添加了新的公共屬性ImportFormatOptions.IgnoreHeaderFooter
• 引入了MarkdownSaveOptions類
• 提供了用于控制LINQ Reporting Engine的JSON簡單值識別的選項

>>你可以點擊這里下載Aspose.Words for .NET v20.6測試體驗

具體更新內(nèi)容

公共API更改

①添加了新的公共類MarkdownSaveOptions

/// <summary>
/// Class to specify additional options when saving a document into the <see cref="Words.SaveFormat.Markdown"/> format.
/// </summary>
public class MarkdownSaveOptions : TxtSaveOptionsBase

暫時只有以下幾個公共API：

/// <summary>
/// Specifies the format in which the document will be saved if this save options object is used.
/// Can only be <see cref="Words.SaveFormat.Markdown"/>.
/// </summary>
public override SaveFormat SaveFormat

注意，將TxtSaveOptionsBase.PreserveTableLayout移至TxtSaveOptions.PreserveTableLayout：

/// <summary>
/// Specifies whether the program should attempt to preserve layout of tables when saving in the plain text format.
/// The default value is <b>false</b>.
/// </summary>
public bool PreserveTableLayout

用例。說明如何創(chuàng)建和使用MarkdownSaveOptions對象：

DocumentBuilder builder = new DocumentBuilder();
builder.Writeln("Some text!");
  
MarkdownSaveOptions saveOptions = (MarkdownSaveOptions)SaveOptions.CreateSaveOptions(SaveFormat.Markdown);
builder.Document.Save("TestDocument.md", saveOptions);

②添加了新的公共屬性Font.EmphasisMark

/// <summary>
/// Gets or sets the emphasis mark applied to this formatting.
/// </summary>
public EmphasisMark EmphasisMark

強調(diào)標記是一個附加字符，它在下面的枚舉中指定的主字符字形之上或之下呈現(xiàn)。

/// <summary>
/// Specifies possible types of emphasis mark.
/// </summary>
/// <dev>
/// Names borrowed from //docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.word.wdemphasismark?view=word-pia
/// </dev>
public enum EmphasisMark
{
    /// <summary>
    /// No emphasis mark.
    /// </summary>
    None = 0x00,
  
    /// <summary>
    /// Emphasis mark is a solid black circle displayed above text.
    /// </summary>
    OverSolidCircle = 0x01,
  
    /// <summary>
    /// Emphasis mark is a comma character displayed above text.
    /// </summary>
    OverComma = 0x02,
  
    /// <summary>
    /// Emphasis mark is an empty white circle displayed above text.
    /// </summary>
    OverWhiteCircle = 0x03,
  
    /// <summary>
    /// Emphasis mark is a solid black circle displayed below text.
    /// </summary>
    UnderSolidCircle = 0x04,
}

用例。說明如何通過DocumentBuilder設(shè)置Font.EmphasisMark：

Document document = new Document();
DocumentBuilder builder = new DocumentBuilder(document);
  
builder.Font.EmphasisMark = EmphasisMark.UnderSolidCircle;
  
builder.Write("Emphasis text");
builder.Writeln();
builder.Font.ClearFormatting();
builder.Write("Simple text");
  
document.Save(savePath, saveOptions);

③添加了新的公共屬性ImportFormatOptions.IgnoreHeaderFooter

/// <summary>
/// Gets or sets a boolean value that specifies that source formatting of headers/footers content ignored
/// if ImportFormatMode.KeepSourceFormatting mode is used.
/// The default value is true.
/// </summary>

默認情況下，保留Word的行為是對的。用例：

Document dstDocument = new Document(dstDocumentPath);
Document srcDocument = new Document(srcDocumentPath);
  
ImportFormatOptions importFormatOptions = new ImportFormatOptions();
importFormatOptions.IgnoreHeaderFooter = false;
  
dstDocument.AppendDocument(srcDocument, ImportFormatMode.KeepSourceFormatting, importFormatOptions);;

④添加了新的公共屬性MarkdownSaveOptions.TableContentAlignment

/// <summary>
/// Gets or sets a value that specifies how to align contents in tables
/// when exporting into the <see cref="Words.SaveFormat.Markdown"/> format.
/// The default value is <see cref="Saving.TableContentAlignment.Auto"/>. 
/// </summary>
public TableContentAlignment TableContentAlignment { get; set; }

此外，還添加了一個新的公共枚舉：

/// <summary>
/// Allows to specify the alignment of the content of the table to be used when exporting into Markdown format.
/// </summary>
public enum TableContentAlignment
{
    /// <summary>
    /// The alignment will be taken from the first paragraph in corresponding table column.
    /// </summary>
    Auto,
    /// <summary>
    /// The content of tables will be aligned to the Left.
    /// </summary>
    Left,
    /// <summary>
    /// The content of tables will be aligned to the Center.
    /// </summary>
    Center,
    /// <summary>
    /// The content of tables will be aligned to the Right.
    /// </summary>
    Right
}

用例。說明導(dǎo)出到Markdown時如何在表格內(nèi)對齊內(nèi)容：

  
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
// Makes all paragraphs inside table to be aligned to Left. 
saveOptions.TableContentAlignment = TableContentAlignment.Left;
builder.Document.Save("left.md", saveOptions);
  
// Makes all paragraphs inside table to be aligned to Right. 
saveOptions.TableContentAlignment = TableContentAlignment.Right;
builder.Document.Save("right.md", saveOptions);
  
// Makes all paragraphs inside table to be aligned to Center. 
saveOptions.TableContentAlignment = TableContentAlignment.Center;
builder.Document.Save("center.md", saveOptions);
  
// Makes all paragraphs inside table to be aligned automatically.
// The alignment in this case will be taken from the first paragraph in corresponding table column.
saveOptions.TableContentAlignment = TableContentAlignment.Auto;
builder.Document.Save("auto.md", saveOptions);