バージョン

WinGridWordWriter について

WinGridWordWriter™ コンポーネントと使用する場合、WinGrid™ コントロールは、新しい Microsoft® Word ドキュメントにデータを書き出すことができます。Word 形式にエクスポートするプロセスは、エクスポート前にレイアウトと外観をデータにどのように適用するかを制御する点で、グリッド データを印刷するプロセスに似ています。さらに、エクスポートにどのデータが含まれるのか、除外されるのかを制御できます。エクスポートはグリッドデータに制限されません。ヘッダー、列グループ、集計行などをすべて含めることができます。

WinGrid データを新しい Word ドキュメントに書き出すために、WinGridWordWriter コンポーネントがアプリケーションに最初に追加されます。WinGridWordWriter コンポーネントでは、 Infragistics.Win.UltraWinGrid.WordWriter および Infragistics.Documents.IO という 2 つのアセンブリへの参照が必要です。このコンポーネントによって、Infragisitcs.Documents.IO アセンブリ内の新しい WordDocumentWriter オブジェクトに基づきエクスポートできます。WordDocumentWriter オブジェクトを使用すると、UltraWinGrid コントロールはメモリにドキュメントを作成することなく直接ファイルにエクスポートされます。ストリーマーを使用するこのアプローチは便利です。このプロセスは、少ない RAM を使用して大きなデータ セットをエクスポートすることで生ずるメモリ問題を回避するからです。

Note

注: このストリーマーは新しいドキュメントを作成するだけなので、WinGrid コントロールから既存の Word ドキュメントにデータをエクスポートすることはできません。

グリッド データの Word ドキュメントへの書き出しは、WinGridWordWriter コンポーネントの Export メソッドを起動することによって開始され、ファイル名またはストリームまたは WordDocumentWriter オブジェクトをオーバーロードとしてエクスポートしたい WinGrid コントロールにそれを渡します。

C# の場合:

using Infragistics.Documents.Word;
// WinGridWordWriter で Export メソッドを呼び出し、
// Grid コントロールと WordDocumentWriter オブジェクトをパラメーターとして渡します
this.ultraGridWordWriter1.Export(ultraGrid1, "C:\Samples_Projects\GridDataInWord.docx");

Visual Basic の場合:

Imports Infragistics.Documents.Word
' WinGridWordWriter で Export メソッドを呼び出し、
' Grid コントロールと WordDocumentWriter オブジェクトをパラメーターとして渡します
Me.ultraGridWordWriter1.Export(ultraGrid1, "C:\Samples_Projects\GridDataInWord.docx")

さらに、WinGridWordWriter コンポーネントは以下のようなさまざまなイベントを公開しています。

これらのイベントは、エクスポート処理できめ細かい制御を行う手助けとなります。