C#を使用して動的にハイパーリンクとブックマークを追加する

ハイパーリンクとブックマークは、ユーザーが関連するコンテンツをすばやくナビゲートするのに便利です。ハイパーリンクをクリックすると、ブラウザでURLが開くか、ドキュメント内の指定されたブックマークの場所に移動します。この記事では、C#を使用してハイパーリンクとブックマークをレポートに動的に追加する方法を学習します。

この記事では、次のトピックについて説明します。

レポートにハイパーリンクとブックマークを動的に追加するには、GroupDocs.Assembly for .NETAPIを使用します。これにより、強力なドキュメント自動化およびレポート生成アプリケーションを構築できます。定義されたテンプレートドキュメントに従ってデータソースからデータをフェッチし、それをアセンブルして、指定された出力形式でレポートを生成します。 APIのDLLをダウンロードするか、NuGetを使用してインストールしてください。

PM> Install-Package GroupDocs.Assembly

リンクタグを使用して、レポートにハイパーリンクを動的に挿入できます。以下に示すように、テンプレートドキュメントでリンクタグを使用できます。

<<link [uri_expression][display_text_expression]>>

uriexpressionは、ハイパーリンクのURIを定義しますが、displaytextexpressionは、ハイパーリンクに表示されるテキストを定義します。

以下の手順に従って、レポートへのハイパーリンクを動的に挿入できます。

  1. DocumentAssemblerクラスのインスタンスを作成します。
  2. 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#を使用して動的にハイパーリンクを追加します。

C#を使用して動的にブックマークを追加する

ブックマークタグを使用して、ブックマークをレポートに動的に挿入できます。以下に示すように、テンプレートドキュメントでブックマークタグを使用できます。

<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>

ブックマーク式は、挿入されるブックマークの名前を定義します。

以下の手順に従って、ブックマークをレポートに動的に挿入できます。

  1. DocumentAssemblerクラスのインスタンスを作成します。
  2. 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"));

前述の手順に従って、ブックマークをドキュメント内のハイパーリンクにリンクすることもできます。ただし、以下に示すように、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#を使用してブックマークをハイパーリンクとして挿入します。

C#を使用してブックマークをハイパーリンクとして挿入します。

無料ライセンスを取得する

無料の一時ライセンスをリクエストして、評価制限なしでAPIを試してください。

結論

この記事では、次の方法を学びました。

  • C#を使用して動的にレポートにハイパーリンクとブックマークを挿入します。
  • ブックマークにハイパーリンクを動的に追加します。

さらに、ドキュメントを使用して、GroupDcos.Assembly for.NETAPIについて詳しく知ることができます。ご不明な点がございましたら、フォーラムまでお気軽にお問い合わせください。

関連項目