ハイパーリンクの追加または変更

Microsoft Word ドキュメントのハイパーリンクは HYPERLINK フィールドです。 Aspose.Words では、ハイパーリンクは FieldHyperlink クラスを通じて実装されます。

ハイパーリンクを挿入する

InsertHyperlink メソッドを使用して、ドキュメントにハイパーリンクを挿入します。このメソッドは 3 つのパラメータを受け入れます。

1. 文書内に表示されるリンクのテキスト
2. リンク先（文書内のURLまたはブックマーク名）
3. URL がドキュメント内のブックマークの名前である場合は true である必要があるブール型パラメーター

InsertHyperlink メソッドでは、URL の先頭と末尾に常にアポストロフィが追加されます。

Font プロパティを使用して、ハイパーリンク表示テキストのフォント形式を明示的に指定する必要があることに注意してください。

次のコード例は、DocumentBuilder を使用してドキュメントにハイパーリンクを挿入する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Please make sure to visit ");
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;

builder.InsertHyperlink("Aspose Website", "http://www.aspose.com", false);

builder.Font.ClearFormatting();
builder.Write(" for more information.");

doc.Save(ArtifactsDir + "AddContentUsingDocumentBuilder.InsertHyperlink.docx");

ハイパーリンクの置換または変更

Microsoft Word ドキュメントのハイパーリンクはフィールドです。前述したように、Word 文書のフィールドは、フィールド開始、フィールド コード、フィールド区切り文字、フィールド結果、フィールド終了を含む複数のノードで構成される複雑な構造です。フィールドはネストでき、豊富なコンテンツを含めることができ、文書内の複数の段落またはセクションにまたがることができます。

ハイパーリンクを置換または変更するには、ドキュメント内でハイパーリンクを検索し、そのテキスト、URL、またはその両方を置換する必要があります。

次のコード例は、Word 文書内のすべてのハイパーリンクを検索し、その URL と表示名を変更する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Hyperlinks.docx");

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 = "http://www.aspose.com";
        hyperlink.Result = "Aspose - The .NET & Java Component Publisher";
    }
}

doc.Save(ArtifactsDir + "WorkingWithFields.ReplaceHyperlinks.docx");