This documentation is archived and is not being maintained.

LocalReport.Render Method (String, String, out String, out String, out String, out String[], out Warning[])

Visual Studio 2008

Processes the report and renders it in the specified format.

Namespace: Microsoft.Reporting.WebForms
Assembly: Microsoft.ReportViewer.WebForms (in microsoft.reportviewer.webforms.dll)

public override byte[] Render (
	string format,
	string deviceInfo,
	out string mimeType,
	out string encoding,
	out string fileNameExtension,
	out string[] streams,
	out Warning[] warnings
public byte[] Render (
	String format, 
	String deviceInfo, 
	/** @attribute OutAttribute() */ /** @ref */ String mimeType, 
	/** @attribute OutAttribute() */ /** @ref */ String encoding, 
	/** @attribute OutAttribute() */ /** @ref */ String fileNameExtension, 
	/** @attribute OutAttribute() */ /** @ref */ String[] streams, 
	/** @attribute OutAttribute() */ /** @ref */ Warning[] warnings
JScript does not support passing value-type arguments by reference.



The format in which to render the report. This argument maps to a rendering extension. Supported formats include Microsoft Office Excel, PDF, and Image.


An XML string that contains the device-specific content that is required by the rendering extension specified in the format parameter. For more information about device information settings for specific output formats, see "Device Information Settings" in SQL Server Books Online.


[out] The MIME type of the rendered report.


[out] The encoding used when rendering the contents of the report.


[out] The file name extension used for the output file.


[out] The stream identifiers. You can use them to render external resources (images, for example) that are associated with the report.


[out] An array of Warning objects that describes any warnings that occurred during report processing.

Return Value

A Byte array of the report in the specified format.

The Render method can be used to export and print a report.

The following code samples assume a Web form application with a ReportViewer control, a button, and a label. In this code example,a local report is loaded into and rendered in the control and then the Render method is used to export the report to Excel format.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using Microsoft.Reporting.WebForms;
using System.IO;

public partial class _Default : System.Web.UI.Page 
    private DataTable LoadSalesData()
        // Load data from XML file.
        DataSet dataSet = new DataSet();
        return dataSet.Tables[0];

    protected void Page_Load(object sender, EventArgs e)
        this.ReportViewer1.ProcessingMode = ProcessingMode.Local;
        this.ReportViewer1.LocalReport.ReportPath = 
           new ReportDataSource("Sales", LoadSalesData()));

    protected void Button1_Click(object sender, EventArgs e)
            Warning[] warnings;
            string[] streamids;
            string mimeType;
            string encoding;
            string extension;

            byte[] bytes = ReportViewer1.LocalReport.Render(
               "Excel", null, out mimeType, out encoding, 
                out extension, 
               out streamids, out warnings);

            FileStream fs = new FileStream(@"c:\output.xls", 
            fs.Write(bytes, 0, bytes.Length);

            Label1.Text = "Report exported to output.xls";