EvaluateHeaderFooterExpressions Delegate
ヘッダーおよびフッターを評価するために、必要に応じて表示拡張機能によって呼び出されます。
名前空間: Microsoft.ReportingServices.ReportRendering
アセンブリ: Microsoft.ReportingServices.ProcessingCore (microsoft.reportingservices.processingcore.dll 内)
構文
'宣言
Public Delegate Sub EvaluateHeaderFooterExpressions ( _
pageNumber As Integer, _
totalPages As Integer, _
report As Report, _
pageReportItems As PageReportItems, _
<OutAttribute> ByRef pageHeader As PageSection, _
<OutAttribute> ByRef pageFooter As PageSection _
)
public delegate void EvaluateHeaderFooterExpressions (
int pageNumber,
int totalPages,
Report report,
PageReportItems pageReportItems,
out PageSection pageHeader,
out PageSection pageFooter
)
public delegate void EvaluateHeaderFooterExpressions (
int pageNumber,
int totalPages,
Report^ report,
PageReportItems^ pageReportItems,
[OutAttribute] PageSection^% pageHeader,
[OutAttribute] PageSection^% pageFooter
)
/** @delegate */
public delegate void EvaluateHeaderFooterExpressions (
int pageNumber,
int totalPages,
Report report,
PageReportItems pageReportItems,
/** @attribute OutAttribute() */ /** @ref */ PageSection pageHeader,
/** @attribute OutAttribute() */ /** @ref */ PageSection pageFooter
)
JScript はデリゲートの使用をサポートしていますが、新規の宣言はサポートしていません。
パラメータ
- pageNumber
現在のページの番号です。
- totalPages
合計ページ数です。
- report
評価される Report オブジェクトです。
- pageReportItems
ページ上のレポート アイテムを含んでいる PageReportItems コレクションです。
- pageHeader
ページ ヘッダーが評価を必要とした場合に、結果として生成されるページ ヘッダーです。これが NULL である場合は、PageHeader を確認してください。
- pageFooter
ページ フッターが評価を必要とした場合に、結果として生成されるページ フッターです。これが NULL である場合は、PageFooter を確認してください。
解説
レポートのページ ヘッダーおよびページ フッターには、レポートのそのページの内容に依存する集計またはその他の情報が含まれる場合があります。Report の NeedsHeaderFooterEvaluation プロパティが true の場合、表示拡張機能は、PageReportItems オブジェクトを生成し、そのページに完全に含まれているすべてのレポート アイテムをコレクションに追加します。次に、表示拡張機能が EvaluateHeaderFooterExpressions 関数を呼び出し、コレクションを渡すと、レポート サーバーが新しいページ ヘッダーとページ フッターを返します。ヘッダーまたはフッターが評価される必要がない場合、それらのヘッダーまたはフッターは、Report オブジェクトで直接使用可能です。ヘッダーは評価される必要があるが、フッターは評価される必要がない場合 (またはその逆) には、フッターはオブジェクト モデルで直接使用できますが、ヘッダーは EvaluateHeaderFooterExpressions の結果から使用できます。
レポート アイテムのコレクションには、ページ内で表示されるアイテムと、常に非表示であるアイテムをすべて含める必要があります。条件によって非表示となるアイテムは、現在非表示である場合には含まれません。
プラットフォーム
開発プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
対象プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。