
ハイパーリンクとブックマークは、ユーザーが関連するコンテンツをすばやくナビゲートするのに便利です。ハイパーリンクをクリックすると、ブラウザでURLが開くか、ドキュメント内の指定されたブックマークの場所に移動します。この記事では、C#を使用してハイパーリンクとブックマークをレポートに動的に追加する方法を学習します。
この記事では、次のトピックについて説明します。
ハイパーリンクとブックマークを動的に追加するC#API
レポートにハイパーリンクとブックマークを動的に追加するには、GroupDocs.Assembly for .NETAPIを使用します。これにより、強力なドキュメント自動化およびレポート生成アプリケーションを構築できます。定義されたテンプレートドキュメントに従ってデータソースからデータをフェッチし、それをアセンブルして、指定された出力形式でレポートを生成します。 APIのDLLをダウンロードするか、NuGetを使用してインストールしてください。
PM> Install-Package GroupDocs.Assembly
C#を使用して動的にハイパーリンクを追加する
リンクタグを使用して、レポートにハイパーリンクを動的に挿入できます。以下に示すように、テンプレートドキュメントでリンクタグを使用できます。
<<link [uri_expression][display_text_expression]>>
uriexpressionは、ハイパーリンクのURIを定義しますが、displaytextexpressionは、ハイパーリンクに表示されるテキストを定義します。
以下の手順に従って、レポートへのハイパーリンクを動的に挿入できます。
- DocumentAssemblerクラスのインスタンスを作成します。
- AssembleDocument()メソッドを呼び出して、ドキュメントをアセンブルします。ソースドキュメントテンプレートパス、ターゲットドキュメントパス、およびデータソースを引数として取ります。
次のコードサンプルは、C#を使用してハイパーリンクを動的に追加する方法を示しています。
// このコード例は、ハイパーリンクを動的に追加する方法を示しています。
// ソースの設定
const string strDocumentTemplate = @"D:\Files\Assembly\Insertinghyperlink.docx";
// 目的地の設定
const string strDocumentReport = @"D:\Files\Assembly\Insertinghyperlink_out.docx";
// ウリ式の設定
const string uriExpression = "https://www.groupdocs.com/";
// 表示テキスト式の設定
const string displayTextExpression = "GroupDocs";
// DocumentAssemblerクラスをインスタンス化します
DocumentAssembler assembler = new DocumentAssembler();
// ドキュメントを組み立てる
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(uriExpression, "uriExpression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));

C#を使用して動的にハイパーリンクを追加します。
C#を使用して動的にブックマークを追加する
ブックマークタグを使用して、ブックマークをレポートに動的に挿入できます。以下に示すように、テンプレートドキュメントでブックマークタグを使用できます。
<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>
ブックマーク式は、挿入されるブックマークの名前を定義します。
以下の手順に従って、ブックマークをレポートに動的に挿入できます。
- DocumentAssemblerクラスのインスタンスを作成します。
- AssembleDocument()メソッドを呼び出して、ドキュメントをアセンブルします。ソースドキュメントテンプレートパス、ターゲットドキュメントパス、およびデータソースを引数として取ります。
次のコードサンプルは、C#を使用してブックマークを動的に追加する方法を示しています。
// このコード例は、ブックマークを動的に追加する方法を示しています。
// ソースの設定
const string strDocumentTemplate = @"D:\Files\Assembly\Insertingbookmark.xlsx";
// 目的地の設定
const string strDocumentReport = @"D:\Files\Assembly\Insertingbookmark_out.xlsx";
// ウリ式の設定
const String bookmark_expression = "gd_bookmark";
// 表示テキスト式の設定
const String displayTextExpression = "GroupDocs";
// DocumentAssemblerクラスをインスタンス化します
DocumentAssembler assembler = new DocumentAssembler();
// ドキュメントを組み立てる
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(bookmark_expression, "bookmark_expression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));
C#を使用してブックマークをハイパーリンクとして挿入
前述の手順に従って、ブックマークをドキュメント内のハイパーリンクにリンクすることもできます。ただし、以下に示すように、uriExpressionとbookmarkexpressionに同じ値を設定する必要があります。
const string bookmark_expression = "gd_bookmark";
const String uriExpression = "gd_bookmark";
次のコードサンプルは、C#を使用してブックマークをハイパーリンクとして挿入する方法を示しています。
// このコード例は、ブックマークをハイパーリンクとして追加する方法を示しています。
// ソースの設定
const string strDocumentTemplate = @"D:\Files\Assembly\input.docx";
// 目的地の設定
const string strDocumentReport = @"D:\Files\Assembly\output.docx";
// ウリ式の設定
const string bookmark_expression = "gd_bookmark";
// 表示テキスト式の設定
const string displayTextExpression = "GroupDocs";
// ウリ式の設定
const String uriExpression = "gd_bookmark";
// 表示テキスト式の設定
const String uriTextExpression = "GroupDocs";
// DocumentAssemblerクラスをインスタンス化します
DocumentAssembler assembler = new DocumentAssembler();
// ドキュメントを組み立てる
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(uriExpression, "uriExpression"),
new DataSourceInfo(uriTextExpression, "uriTextExpression"),
new DataSourceInfo(bookmark_expression, "bookmark_expression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));

C#を使用してブックマークをハイパーリンクとして挿入します。
無料ライセンスを取得する
無料の一時ライセンスをリクエストして、評価制限なしでAPIを試してください。
結論
この記事では、次の方法を学びました。
- C#を使用して動的にレポートにハイパーリンクとブックマークを挿入します。
- ブックマークにハイパーリンクを動的に追加します。
さらに、ドキュメントを使用して、GroupDcos.Assembly for.NETAPIについて詳しく知ることができます。ご不明な点がございましたら、フォーラムまでお気軽にお問い合わせください。