バージョン

エクスポート イベントを処理することでエクスポートを管理

DataPresenterWordWriter オブジェクトは、エクスポート処理を変更するために処理可能なイベントをいくつか公開します。エクスポート処理の間にエクスポートされる要素ごとにイベントが発生します。たとえば、エクスポートされる列ヘッダーごとに LabelExporting イベントが発生します。ほとんどのイベントによって、フォーマットを適用する、またはエクスポートされる値を変更するなど、エクスポートされたデータを変更することができます。

表 1 では、サポートされるエクスポート イベントを、発生する順序に説明します。

表 1: エクスポート イベントの説明

イベント 説明

レコードがエクスポートされる前にエクスポート処理の開始時に発生します。このイベントは、エクスポート操作に使用されるグリッドのイベントをフックする、またはレコードのエクスポートの前にコンテンツを WordDocumentWriter に追加するために使用されます。

DataRecord、GroupByRecord、SummaryRecord または ExpandableFieldRecord をエクスポートする前に発生します。指定されたレコード、その兄弟レコードまたは子孫レコードのエクスポートをスキップできます。InitializeRecordEventArgsTerminateExport プロパティを設定することで、エクスポート処理をキャンセルすることも可能です。

列ヘッダーをエクスポートする前に発生します。

データ レコード値をエクスポートする前に発生します。

集計の各結果をエクスポートする前に発生します。

ExportEnded イベントの直前に発生して、現在のエクスポート処理に関するキャンセル情報 (ある場合) を提供します。関連付けられた WordDocumentWriter が閉じる前にこのイベントが発生します。これによって閉じる前に追加情報をドキュメントに追加できます。

エクスポート処理の終わりに発生し、完了を通知します。