The WebReportViewer control is a component which you can add to your Visual Studio® toolbox, and then drop onto a Web Form. (For help with this, see Adding Components to the Visual Studio Toolbox.) The control is only available in Web projects, and is disabled in Windows Application projects.

At design time, only a gray box is shown on the WebForm.

At run time, the WebReportViewer control offers the user the same features that can be found in the ReportPreview control. At design time, the control includes all of the separate sections listed below already packaged for ease of use.

Individual sections

• CoreViewer is the section that displays the current page of the report. It may also be used to display messages, such as "Loading report," or "Waiting for parameters."
• DocumentMapPanel is the basic Table of Contents (TOC) panel for document navigation. It displays the interactive document map as a treeview at run time.
• FindPanel is the basic panel that offers users an interface for searching the document. At run time, it displays a list of results that the user can click to navigate.
• ParameterPanel is the basic panel for accepting parameter input from users.
• Toolbar is the basic toolbar that allows for interaction with the report through navigation, viewer modes, export options, et cetera. The toolbar contains the following buttons:
  
  1. Back to Parent Report enables the user to navigate back to the previous report after they have followed a drill through link.
  2. Hide/Show Side Bar allows the user to open or close the side bar where they can select from any of the panels that you may have added to the CoreViewer.
     • Report Parameters provides access to the ParameterPanel control in which users can change the parameters on which to base the report.
     • Find provides access to the FindPanel control which allows users to search the report for key words.
     • Document Map provides access to the DocumentMapPanel and (if a document map is provided as a part of the report) allows users to navigate the report from table of contents entries in the treeview.
  3. Page Setup opens a dialog with paper size, page margins and orientation options.
  4. Print opens a print dialog with printer, print range, and page handling options.
  5. Print Preview shows the individual pages of the report instead of a single html page.
  6. Viewer Mode allows users to select HTML or PDF from the drop-down box, and then click the Viewer Mode button to change modes.
  7. Go to First Page navigates to the first page of the report.
  8. Back navigates to the page immediately prior to the current page. (This button is disabled when the first page of the report is in view.)
  9. Forward navigates to the page immediately after the current page. (This button is disabled when the last page of the report is in view.)
  10. Go to End Page navigates to the last page of the report.
  11. Select a format allows users to select from Acrobat (PDF) File or Web Archive from the drop-down box, and then click the Export button to export the report.
  12. Export exports the report to the selected format.
  13. E-mail opens a dialog which allows users to enter e-mail addresses in the To and From fields, as well as a subject and notes.
      

See Also