ActiveReports 19 .NET Edition
MESCIUS.ActiveReports Assembly / GrapeCity.ActiveReports.Document Namespace / PageDocument Class / Render Method / Render(IRenderingExtension,StreamProvider,NameValueCollection,Boolean) Method
Rendering extension to use to render a report.
The GrapeCity.ActiveReports.Extensibility.Rendering.IO.StreamProvider to store the rendered report output.
The System.Collections.Specialized.NameValueCollection that contains the settings for the GrapeCity.ActiveReports.Extensibility.Rendering.IRenderingExtension.
Set to True to force a refresh or query of the data even if the DataMap has already retrieved the required data.
Example

In This Topic
    Render(IRenderingExtension,StreamProvider,NameValueCollection,Boolean) Method
    In This Topic
    Renders a report using the specified rendering extension with the specified values and refreshed data.
    Syntax
    'Declaration
 
Public Overloads Sub Render( _
   ByVal renderingExtension As IRenderingExtension, _
   ByVal streams As StreamProvider, _
   ByVal settings As NameValueCollection, _
   ByVal forceDataRefresh As Boolean _
) 
    public void Render( 
   IRenderingExtension renderingExtension,
   StreamProvider streams,
   NameValueCollection settings,
   bool forceDataRefresh
)

    Parameters

    renderingExtension
    Rendering extension to use to render a report.
    streams
    The GrapeCity.ActiveReports.Extensibility.Rendering.IO.StreamProvider to store the rendered report output.
    settings
    The System.Collections.Specialized.NameValueCollection that contains the settings for the GrapeCity.ActiveReports.Extensibility.Rendering.IRenderingExtension.
    forceDataRefresh
    Set to True to force a refresh or query of the data even if the DataMap has already retrieved the required data.
    Exceptions
    ExceptionDescription
    System.ArgumentNullExceptionThrown if the renderingExtension or streams is null.
    GrapeCity.ActiveReports.ReportExceptionThrown if a report-specific error occured.
    System.ComponentModel.LicenseExceptionThrown when a component cannot be granted a license.
    GrapeCity.ActiveReports.Rdl.Validation.ValidationReportExceptionThrown if validation problems occurred.
    GrapeCity.ActiveReports.Core.Rendering.ReportParameters.ReportParameterExceptionThrown when an error related to a report's parameter occurs.
    System.OperationCanceledExceptionThrown in a thread upon cancellation of an operation that the thread was executing.
    Example
    Settings settings = new Settings();
settings.HideToolbar = true;
settings.HideMenubar = true;
settings.HideWindowUI = true;
settings.Author = "Joe Smith";
PdfRenderingExtension renderingExtension = new PdfRenderingExtension();
DirectoryInfo di = new DirectoryInfo(@"D:\Report");
FileStreamProvider exportfile = new FileStreamProvider(di, "MyReport");
pageReport.Document.Render(renderingExtension, exportfile, settings, true);
    See Also

    Reference

    PageDocument Class
    PageDocument Members
    Overload List