Report.NeedsHeaderFooterEvaluation Property

Article
12/03/2008

Gets a value that indicates whether this page header or page footer needs to be evaluated during rendering.

Namespace: Microsoft.ReportingServices.ReportRendering
Assembly: Microsoft.ReportingServices.ProcessingCore (in microsoft.reportingservices.processingcore.dll)

Syntax

'Declaration
Public ReadOnly Property NeedsHeaderFooterEvaluation As Boolean

public bool NeedsHeaderFooterEvaluation { get; }

public:
property bool NeedsHeaderFooterEvaluation {
    bool get ();
}

/** @property */
public boolean get_NeedsHeaderFooterEvaluation ()

public function get NeedsHeaderFooterEvaluation () : boolean

Property Value

A Boolean indicating whether this page header or page footer needs to be evaluated during rendering. If true, ReportItemCollection is null and the rendering extension should call the EvaluateHeaderFooterExpressions function after it has built the page.

Remarks

New:5 December 2005

The page header and footer of a report may include aggregates or other information that is dependent on the contents of that page of the report. The report server provides a callback delegate function called EvaluateHeaderFooterExpressions. If NeedsHeaderFooterEvaluation is true, the rendering extension creates a PageReportItems object and adds all the report items that are completely contained on the page into that collection. The rendering extension then calls the EvaluateHeaderFooterExpressions function, passing in the collection, and the report server returns the new page header and page footer. In the case that the header needs to be evaluated but the footer does not, or the footer needs evaluation but the header does not, the one needing evaluation is available from the result of EvaluateHeaderFooterExpressions, while the one that does not need evaluation is available directly in the report object model.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms