アプリケーションのライセンスの組み込み
このトピックでは、アプリケーションにActiveReports for .NETのライセンスを組み込む方法について説明します。
ActiveReports for .NETを使用したアプリケーションを配布する場合は、正規の開発ライセンスを使用して作成されたことを示すライセンス情報をアプリケーションに組み込む必要があります。
このトピックの内容は、.NET Frameworkアプリケーションの場合に必要な作業です。.NETアプリの場合は、不要です。
自動で組み込む
デザイン時に、ActiverReports for .NETのコントロールをフォームに追加するか、または、セクションレポート（コード）をプロジェクトに追加することで、ライセンスファイル（「licenses.licx」ファイル）が自動的に作成され、必要なライセンスがプロジェクトに組み込まれます。
ページレポート、RDLレポート、ダッシュボード、セクションレポート（XML）をプロジェクトに追加した時には、「licenses.licx」ファイルが自動的に作成されず、ライセンス情報も追加されません。次の「手動で組み込む」の手順で、必要なライセンス情報をプロジェクトに組み込んでください。
「licenses.licx」ファイルは、デフォルトで、以下のフォルダに配置されます。
言語 | フォルダ |
|---|---|
Visual Basic |
|
C# |
|
手動で組み込む
実行時にコントロールを作成する場合は、「licenses.licx」ファイルを作成して、必要なライセンス情報を記載する必要があります。
ActiveReports for .NET のプロジェクトを開きます。
［プロジェクト］メニューから、［新しい項目の追加］を選択します。
テンプレートから、［テキストファイル］を選択します。
テキストファイルの名前を、「licenses.licx」に変更して、追加します。
「licenses.licx」を開いて、以下のライセンス情報を追加します。プロジェクトで使用している機能に該当するものだけ追加してください。
GrapeCity.ActiveReports.SectionReport, MESCIUS.ActiveReports
GrapeCity.ActiveReports.PageReport, MESCIUS.ActiveReports
GrapeCity.ActiveReports.Viewer.Win.Viewer, MESCIUS.ActiveReports.Viewer.Win
GrapeCity.ActiveReports.Export.Pdf.Section.PdfExport, MESCIUS.ActiveReports.Export.Pdf
GrapeCity.ActiveReports.Web.WebViewer, MESCIUS.ActiveReports.Web
GrapeCity.ActiveReports.Design.Designer, MESCIUS.ActiveReports.Design.Win
GrapeCity.ActiveReports.Viewer.Wpf.Viewer, MESCIUS.ActiveReports.Viewer.Wpf
GrapeCity.ActiveReports.Aspnet.WebViewer, MESCIUS.ActiveReports.Aspnet.Viewer
GrapeCity.ActiveReports.Aspnet.WebDesigner, MESCIUS.ActiveReports.Aspnet.Designer各ライセンス情報に対応する機能は、以下の通りです。
ライセンス情報 | 機能 |
|---|---|
| セクションレポート |
| ページレポート、RDLレポート、ダッシュボード |
| ビューワ |
| PDFエクスポート |
| WebViewer（Professionalのみ） |
| デザイナ（Professionalのみ） |
| WPFビューワ |
| JSビューワ、Blazorビューワ~~~~（Professionalのみ） |
| Webデザイナ、Blazorデザイナ（Professionalのみ） |
プロジェクトで使用しているレポートの種類に応じて、必要なライセンス情報を記載してください。
セクションレポートを使用している場合は、
GrapeCity.ActiveReports.SectionReport, MESCIUS.ActiveReportsを記載してください。ページレポート／RDLレポート／ダッシュボードを使用している場合は、
GrapeCity.ActiveReports.PageReport, MESCIUS.ActiveReportsを記載してください。セクションレポート、および、ページレポート／RDLレポート／ダッシュボードのどちらも使用している場合は、２つのライセンス情報を記載してください。
なお、いずれか１つのレポートの種類のみを使用しているプロジェクトの場合に、２つのライセンス情報を記載しても、特に問題ありません。
プロジェクトで使用している機能に該当するライセンス情報のみ、記載してください。
セクションレポート（コード）を使う場合、プロジェクトに「MESCIUS.ActiveReports.Design.Win」の参照が追加されますが、「licenses.licx」ファイルへの記載は必要ありません。
「licenses.licx」ファイルのプロパティを表示し、［ビルド アクション］が「埋め込みリソース」になっていることを確認します。
プロジェクトを保存し、ソリューションをリビルドします。これにより、ActiveReportsのライセンスが組み込まれます。
エラーが発生する場合は、以下のナレッジを参照してください。
Azure Functions
通常の「.NETアプリケーション」と異なり、「Azure Functionsアプリケーション」にライセンスの付与を行う際は、C:\ProgramData\SA3内のsa3clientを利用してライセンスを付与する必要があります。
ライセンス設定方法の詳細は、「Azure FunctionsとActiveReports for .NETでつくる帳票生成API – 2026年版 | MESCIUS.devlog - メシウス株式会社」を参照してください。製品IDは、ARPJです。
他のアセンブリから利用する場合
ActiveReports for .NET をクラスライブラリなどで使用し、他のアセンブリからクラスライブラリを通して再利用する場合は、呼び出し元のプロジェクトに、ActiveReports for .NET のライセンス情報を記載した「licenses.licx」ファイルが必要です。以下の手順で、呼び出し元のプロジェクトにライセンスを組み込んでください。
呼び出し元のプロジェクトを開きます。
「手動で組み込む」の（手順２）以降を実施します。
複数のプロジェクトを使用している場合は、最初に実行されるプロジェクトにライセンス情報が必要である点にご注意ください。クラスライブラリを経由してActiveReportsの機能を使用するときの注意事項 – MESCIUS ナレッジベース
注意事項
「licenses.licx」ファイルに必要なライセンス情報が記載されていない場合、実行時に、「XXXX（コントロール名）のライセンスが見つかりませんでした。」というエラーが発生します。
「licenses.licx」ファイルにプロジェクトで使用していない機能のライセンス情報が記載されている場合、ビルド時に、「"LC.exe" はコード -1 を伴って終了しました。」というエラーが発生し、ビルドが中断される場合があります。
「licenses.licx」ファイルが自動で作成された場合は、次のような長いライセンス情報が記載されます。
GrapeCity.ActiveReports.SectionReport, MESCIUS.ActiveReports, Version=x.x.x.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff後半の「, Version=x.x.x.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff」の部分は、ビルド時のバージョンチェックを厳密に行うための情報であり、削除しても問題ありません。