Word格式處理控件Aspose.Words for .NET教程——使用超鏈接和HTML

Aspose.Words for .NET是一種高級(jí)Word文檔處理API，用于執(zhí)行各種文檔管理和操作任務(wù)。API支持生成，修改，轉(zhuǎn)換，呈現(xiàn)和打印文檔，而無需在跨平臺(tái)應(yīng)用程序中直接使用Microsoft Word。此外，API支持所有流行的Word處理文件格式，并允許將Word文檔導(dǎo)出或轉(zhuǎn)換為固定布局文件格式和最常用的圖像/多媒體格式。

>>Aspose.Words for .NET已經(jīng)更新至v20.7，添加了新節(jié)點(diǎn)以處理多節(jié)結(jié)構(gòu)化文檔標(biāo)簽，改進(jìn)了SmartArt冷渲染的性能，RevisionOptions類擴(kuò)展了新的屬性，點(diǎn)擊下載體驗(yàn)

插入超鏈接

用于DocumentBuilder.InsertHyperlink 在文檔中插入超鏈接。此方法接受三個(gè)參數(shù)：要在文檔中顯示的鏈接的文本，鏈接目標(biāo)（URL或文檔中書簽的名稱）以及布爾值參數(shù)（如果URL是其中的書簽名稱，則應(yīng)為true）文件。DocumentBuilder.InsertHyperlink 內(nèi)部調(diào)用 DocumentBuilder.InsertField。該方法始終在URL的開頭和結(jié)尾添加撇號(hào)。請(qǐng)注意，需要使用該Font 屬性為超鏈接顯示文本指定字體格式。下面的示例使用DocumentBuilder將超鏈接插入文檔中。

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

builder.Write("Please make sure to visit ");

// Specify font formatting for the hyperlink.
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;
// Insert the link.
builder.InsertHyperlink("Aspose Website", "http://www.aspose.com", false);

// Revert to default formatting.
builder.Font.ClearFormatting();

builder.Write(" for more information.");
dataDir = dataDir + "DocumentBuilderInsertHyperlink_out.doc";
doc.Save(dataDir);

替換或修改超鏈接

Microsoft Word文檔中的超鏈接是一個(gè)字段。Word文檔中的字段是一個(gè)復(fù)雜的結(jié)構(gòu)，由多個(gè)節(jié)點(diǎn)組成，這些節(jié)點(diǎn)包括字段開頭，字段代碼，字段分隔符，字段結(jié)果和字段結(jié)尾。字段可以嵌套，包含豐富的內(nèi)容，并且可以跨越文檔中的多個(gè)段落或部分。FieldHyperlink類實(shí)現(xiàn)HYPERLINK字段。 下面的示例查找Word文檔中的所有超鏈接，并更改其URL和顯示名稱。

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_WorkingWithHyperlink();
string NewUrl = @"http://www.aspose.com";
string NewName = "Aspose - The .NET & Java Component Publisher";
Document doc = new Document(dataDir + "ReplaceHyperlinks.doc");

// Hyperlinks in a Word documents are fields.
foreach (Field field in doc.Range.Fields)
{
    if (field.Type == FieldType.FieldHyperlink)
    {
        FieldHyperlink hyperlink = (FieldHyperlink)field;

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink.SubAddress != null)
            continue;

        hyperlink.Address = NewUrl;
        hyperlink.Result = NewName;
    }
}

dataDir = dataDir + "ReplaceHyperlinks_out.doc";
doc.Save(dataDir);

插入HTML

您可以輕松地將包含HTML片段或整個(gè)HTML文檔的HTML字符串插入Word文檔。只需將此字符串傳遞給 DocumentBuilder.InsertHtml 方法即可。該方法的有用實(shí)現(xiàn)之一是在郵件合并期間將HTML字符串存儲(chǔ)在數(shù)據(jù)庫中并將其插入文檔中，以獲取添加的格式化內(nèi)容，而不是使用文檔構(gòu)建器的各種方法來構(gòu)建它。下面的示例顯示使用DocumentBuilder將HTML插入文檔中。

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

builder.InsertHtml(
    "<P align='right'>Paragraph right</P>" +
    "<b>Implicit paragraph left</b>" +
    "<div align='center'>Div center</div>" +
    "<h1 align='left'>Heading 1 left.</h1>");
dataDir = dataDir + "DocumentBuilderInsertHtml_out.doc";
doc.Save(dataDir);