ActiveReports for .NET 18.0J
Wordへの描画
ActiveReportsユーザーガイド > エクスポート > 描画拡張機能 > Wordへの描画

ActiveReportsのレポートは、WordRenderingExtensionクラスを使用してMSWordのネイティブ形式で描画することができます。ページレポート/RDLレポートは、FileFormatプロパティを使用することで、Officeオープンxml (OOXML)形式(.Docx)やWord HTML形式(.Doc)でエクスポートすることができます。

レポートをWord形式でエクスポートするには、プロジェクトに以下のパーケッジを追加します。

Officeオープンxml形式(.Docx)は以下のシナリオでの使用に適しています。

以下は、レポートをMicrosoft Word形式でエクスポートする手順の一例です。

  1. 新規プロジェクトとして「ページレポート(またはRDLレポート)アプリケーション」を作成します。詳細な手順については、「ActiveReportsアプリケーションを追加する」を参照してください。
  2. プロジェクトにMESCIUS.Activereports.Export.Word.jaパッケージを追加します。
  3. Form.cs(またはForm.vb)を開き、タイトルバーをダブルクリックしてForm_Loadイベントを作成します。
  4. 以下のコードをForm_Loadイベント内に追加し、レポートをOOXML形式、またはHTML形式でエクスポートします。
レポートをMicrosoft Word 97-2003形式(.Doc)でエクスポートするには、FileFormatプロパティを「OOXML」から「HTML」に変更します。 
wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.HTML
Visual Basicコード(Form_Loadイベント内に貼り付けます。)
コードのコピー
' 描画するページレポートを指定します。
Dim rptPath As New IO.FileInfo("..\..\PageReport1.rdlx")
Dim pageReport As New GrapeCity.ActiveReports.PageReport(rptPath))

' 出力先のディレクトリを作成します。
Dim outputDirectory As New System.IO.DirectoryInfo("C:\MyWord")
outputDirectory.Create()

' エクスポートの各種設定を行います。
Dim wordSetting As New GrapeCity.ActiveReports.Export.Word.Page.Settings()

' FileFormatプロパティを.OOXMLに設定します。
wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.OOXML

' RenderingExtensionを使用し、レポートをエクスポートします。
Dim wordRenderingExtension As New GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension()
Dim outputProvider As New GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name))

' 出力ファイルがすでに存在する場合は上書きします。
outputProvider.OverwriteOutputFile = True

pageReport.Document.Render(wordRenderingExtension, outputProvider, wordSetting)
C#コード(Form_Loadイベント内に貼り付けます。)
コードのコピー
// 描画するページレポートを指定します。
System.IO.FileInfo rptPath = new System.IO.FileInfo(@"..\..\PageReport1.rdlx");
GrapeCity.ActiveReports.PageReport pageReport = new GrapeCity.ActiveReports.PageReport(rptPath);

// 出力先のディレクトリを作成します。
System.IO.DirectoryInfo outputDirectory = new System.IO.DirectoryInfo(@"C:\MyWord");
outputDirectory.Create();

// エクスポートの各種設定を行います。
GrapeCity.ActiveReports.Export.Word.Page.Settings wordSetting = new GrapeCity.ActiveReports.Export.Word.Page.Settings(); 

// FileFormatプロパティを.OOXMLに設定します。
wordSetting.FileFormat = GrapeCity.ActiveReports.Export.Word.Page.FileFormat.OOXML;

// RenderingExtensionを使用し、レポートをエクスポートします。
GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension wordRenderingExtension = new GrapeCity.ActiveReports.Export.Word.Page.WordRenderingExtension();
GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider outputProvider = new GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name));

// 出力ファイルがすでに存在する場合は上書きします。
outputProvider.OverwriteOutputFile = true;

pageReport.Document.Render(wordRenderingExtension, outputProvider, wordSetting);

Wordエクスポート(描画拡張機能)のプロパティ

ActiveReportsには、Microsoft Wordへのレポートのエクスポートを制御するオプションが用意されています。

共有のプロパティ (HTML形式 および OOXML形式)

プロパティ 説明
Author エクスポートされたWordファイルの「作成者」プロパティを設定します。
FileFormat エクスポートされたドキュメントのフォーマットを「Office Open XML (OOXML)形式(.Docx)」、または「Word HTML形式(.Doc)」に指定します。デフォルトのフォーマットは「Word HTML形式」です。
Title エクスポートされたWordファイルの「タイトル」プロパティを設定します。

HTML 形式

プロパティ 説明
BaseUrl レポートで使用される相対ハイパーリンクのベースURLを入力します。この値は、Microsoft Wordアプリケーションの[ファイルのプロパティ]ダイアログの[概要]タブにある[ハイパーリンクの基点]フィールドに表示されます。
Generator 描画したWordドキュメントのドキュメント生成の識別子を設定します。
PageHeight 描画したWordドキュメントのレポートのページの高さの値(インチ単位)を入力します。このプロパティの値は、元のレポートの設定をオーバーライドしています。
PageWidth Wordドキュメントに描画したレポートのページの幅の値(インチ単位)を入力します。このプロパティの値は、元のレポートの設定をオーバーライドしています。
UseMhtOutput

Wordドキュメントを生成する際にMHT出力を使用するかどうかを指定します。

OOXML 形式

プロパティ 説明
CompanyName 描画したWordドキュメントのプロパティダイアログのCompanyフィールドに表示される組織名、あるいは会社名を設定します。
DocumentCompatibilityVersion

ドキュメントの互換モードを「Microsoft Word 2013」、または「Microsoft Word 2007-2010」に設定します。デフォルトでは「Microsoft Word2007」に設定されています。

DpiX Microsoft Wordアプリケーションにある画像の水平解像度を設定します。デフォルトでは「96」に設定されています。
DpiY Microsoft Wordアプリケーションにある画像の垂直解像度を設定します。デフォルトでは「96」に設定されています。
PageOrientation

エクスポートしたドキュメントの印刷の向き(「縦」あるいは「横」)を指定します。

PaperSize ページの用紙サイズを設定します。
Password 描画したWordドキュメントを開く際に必要となるパスワードを設定します。
ReadOnlyRecommended MicrosoftWordドキュメントを開くたびに、読み取り専用であることを示すメッセージを表示させるか否かを設定します。
WritePassword 描画したWordドキュメントの変更を保存する際に必要となる書き込みパスワードを設定します。
TOCAutoUpdate Wordドキュメントを開く際にTableOfContentsコントロールを自動更新します。デフォルトでは「False」に設定されています。

制限事項

HTML形式

OOXML形式

(1)レポートプロパティ

(2)レポートコントロール


対話的な機能

HTML 形式

Word形式でレンダリングされたレポートは、ブックマークとハイパーリンクをサポートします。ただし、(ドリルダウンレポートで見られるような)表示/非表示の切り替えが不可欠な場合は、HTML描画拡張機能の使用を推奨します。また、見出しマップが不可欠な場合は、PDF描画拡張機能の使用を推奨します。

OOXML 形式


関連トピック