SetPageSettings Method

ReportViewer.SetPageSettings Method

Visual Studio 2010

Sets the page settings that are used to print the current report in the ReportViewer control or display it in print layout mode.

Namespace: Microsoft.Reporting.WinForms
Assembly: Microsoft.ReportViewer.WinForms (in microsoft.reportviewer.winforms.dll)

public void SetPageSettings (
	PageSettings pageSettings
public void SetPageSettings (
	PageSettings pageSettings
public function SetPageSettings (
	pageSettings : PageSettings



A PageSettings object that contains the new page settings.

This parameter must not be null.

By default, the ReportViewer control uses the page settings specified in the report definition when printing the current report or displaying it in print layout mode. Use this method to change the page settings for the current report (not the current page), such as margins or paper size. This method validates the margin and page size values in the pageSettings parameter. Note that the change only affects the current report in the ReportViewer control, and does not affect its parent report or the drillthrough reports accessible from it.

The ReportViewer control uses the pageSettings.PrinterSettings property to initialize the Print dialog, but does not validate the pageSettings.PrinterSettings property. The printer settings in pageSettings.PrinterSettings affect all reports displayed in the ReportViewer control. If pageSettings.PrinterSettings is null, the existing printer settings remain unchanged.

If the ReportViewer control is in print layout mode when this method is called, the it cancels any currently running report rendering operation and rerenders the report immediately.

© 2016 Microsoft