Microsoft.Reporting.WebFormsClient.ReportViewer Class
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Provides properties, methods, and events for client-side programming of the ReportViewer control.

An instance of this class is created by the ReportViewer control. To access the handle to this instance, use the Sys.Application $find Method.

var v = $find(viewerId);
Members

Name Description

Microsoft.Reporting.WebFormsClient.ReportViewer.ReportAreaContent Enumeration

Specifies the current state of the report area.

Microsoft.Reporting.WebFormsClient.ReportViewer.reportAreaChanged Event

Occurs when the report area is changed.

Microsoft.Reporting.WebFormsClient.ReportViewer.exportReport Method

Exports the report to the specified format.

Microsoft.Reporting.WebFormsClient.ReportViewer.find Method

Causes the server control to search for a string in the report.

Microsoft.Reporting.WebFormsClient.ReportViewer.findNext Method

Finds the next search hit in the report.

Microsoft.Reporting.WebFormsClient.ReportViewer.invokePrintDialog Method

Launches the print dialog.

Microsoft.Reporting.WebFormsClient.ReportViewer.refreshReport Method

Refreshes the report.

Microsoft.Reporting.WebFormsClient.ReportViewer.documentMapVisibility Property

Gets or sets a Boolean value that indicates whether the document map is visible.

Microsoft.Reporting.WebFormsClient.ReportViewer.isLoading Property

Gets a Boolean value that indicates whether the server control is loading a report.

Microsoft.Reporting.WebFormsClient.ReportViewer.promptAreaCollapsed Property

Gets or sets a Boolean value that indicates whether the parameter prompt area is visible.

Microsoft.Reporting.WebFormsClient.ReportViewer.reportAreaContent Property

Gets the current report area state.

Microsoft.Reporting.WebFormsClient.ReportViewer.zoomLevel Property

Gets or sets the current zoom level.

Remarks

Depending on the state of the ReportViewer server control, accessing the methods and properties of the client side API may cause an exception. For example, When the Web page or the ReportViewer server control is performing a postback, accessing any of the methods or properties will cause an exception with the message: "The report or page is being updated. Please wait for the current action to complete."

When the Web page or the ReportViewer server control is not performing a postback, a set of methods require that a report is loaded. If no report is loaded, invoking those methods will cause an exception with the message: "The operation cannot be performed because there is no report loaded." See below for the applicable methods.

Handling Property Change Events

If you want to be notified when a property is changed, register an event handler with the Sys.Component.propertyChanged Event. This event is part of the ReportViewer instance's base class, the Sys.Component Class. For example:

<script language="JavaScript">
   function propertyChangedHandler(sender, e)
   {
      alert("prop changed");
   }

   var rViewer = $find(viewerId);
   rViewer.add_propertyChanged(propertyChangedHandler);</script>
Page view tracker