Share via


LocalReport Class

 

Represents a report that is processed and rendered locally without connecting to a report server.

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

Inheritance Hierarchy

System.Object
  Microsoft.Reporting.WinForms.Report
    Microsoft.Reporting.WinForms.LocalReport

Syntax

[SerializableAttribute]
public sealed class LocalReport : Report, ISerializable, IDisposable
[SerializableAttribute]
public ref class LocalReport sealed : Report, ISerializable, 
    IDisposable
[<Sealed>]
[<SerializableAttribute>]
type LocalReport = 
    class
        inherit Report
        interface ISerializable
        interface IDisposable
    end
<SerializableAttribute>
Public NotInheritable Class LocalReport
    Inherits Report
    Implements ISerializable, IDisposable

Constructors

Name Description
System_CAPS_pubmethod LocalReport()

Initializes a new instance of the LocalReport class.

Properties

Name Description
System_CAPS_pubproperty DataSources

Gets a collection of data sources used by the report.

System_CAPS_pubproperty DisplayName

Gets or sets the display name of the report.(Inherited from Report.)

System_CAPS_pubproperty EnableExternalImages

Indicates whether the report can be rendered if it has external images.

System_CAPS_pubproperty EnableHyperlinks

Indicates whether the report can be rendered if it contains hyperlink actions.

System_CAPS_pubproperty IsDrillthroughReport

Indicates whether the report is a drillthrough report.(Inherited from Report.)

System_CAPS_pubproperty IsReadyForRendering

Gets a Boolean value that indicates whether a report definition and all required parameters have been specified, and all data sources are ready for use. (Inherited from Report.)

System_CAPS_pubproperty MapTileServerConfiguration

Defines configuration settings for Microsoft Bing Maps SOAP Services that provides a tile background for map report items in the report.

System_CAPS_pubproperty OriginalParametersToDrillthrough

Returns the parameters passed from a parent report to this report, if it is a drillthrough report.

System_CAPS_pubproperty ReportEmbeddedResource

Gets or sets the name of the report-embedded resource.

System_CAPS_pubproperty ReportPath

Gets or sets the file system path of the local report.

System_CAPS_pubproperty ShowDetailedSubreportMessages

Gets or sets a boolean value that indicates whether detailed messages should be displayed when an error occurs in a subreport.

Methods

Name Description
System_CAPS_pubmethod AddFullTrustModuleInSandboxAppDomain(StrongName)

Adds the supplied assembly to the list of assemblies that run in full trust mode in the sandboxed application domain.

System_CAPS_pubmethod AddTrustedCodeModuleInCurrentAppDomain(String)

Obsolete.Adds the supplied assembly to the list of assemblies that are trusted to execute in the current AppDomain.

System_CAPS_pubmethod Dispose()

Releases all resources that are used by the LocalReport object.

System_CAPS_pubmethod Equals(Object)

(Inherited from Object.)

System_CAPS_pubmethod ExecuteReportInCurrentAppDomain(Evidence)

Obsolete.Causes processing extensions and expressions in the report to be executed in the current AppDomain.

System_CAPS_pubmethod ExecuteReportInSandboxAppDomain()

Obsolete.Causes processing extensions and expressions to be run in an application domain with limited permissions.

System_CAPS_pubmethod GetDataSourceNames()

Returns the names of all datasets used within the local report.

System_CAPS_pubmethod GetDefaultPageSettings()

Gets the default page settings specified in the local report.(Overrides Report.GetDefaultPageSettings().)

System_CAPS_pubmethod GetDocumentMap()

Returns the representation of the document map for the local report.(Inherited from Report.)

System_CAPS_pubmethod GetHashCode()

(Inherited from Object.)

System_CAPS_pubmethod GetParameters()

Returns report parameter properties for the report. (Overrides Report.GetParameters().)

System_CAPS_pubmethod GetTotalPages()

Returns the total number of soft pages in the report. (Inherited from Report.)

System_CAPS_pubmethod GetTotalPages(PageCountMode)

Returns the total number of soft pages in the report and a PageCountMode enumeration value that indicates the current page count mode.(Overrides Report.GetTotalPages(PageCountMode).)

System_CAPS_pubmethod GetType()

(Inherited from Object.)

System_CAPS_pubmethod ListRenderingExtensions()

Returns all available rendering extensions for the local report.(Overrides Report.ListRenderingExtensions().)

System_CAPS_pubmethod LoadReportDefinition(Stream)

Loads a report definition for processing using a Stream.(Inherited from Report.)

System_CAPS_pubmethod LoadReportDefinition(TextReader)

Loads a report definition from the local file system using a TextReader.(Overrides Report.LoadReportDefinition(TextReader).)

System_CAPS_pubmethod LoadSubreportDefinition(String, Stream)

Loads a subreport definition using a Stream.

System_CAPS_pubmethod LoadSubreportDefinition(String, TextReader)

Loads a subreport definition using a TextReader.

System_CAPS_pubmethod Refresh()

Causes the local report to be rendered with new data.(Overrides Report.Refresh().)

System_CAPS_pubmethod ReleaseSandboxAppDomain()

Causes the LocalReport object to release its reference to the sandboxed application domain immediately.

System_CAPS_pubmethod Render(String)

Processes the report and renders it in the specified format.(Inherited from Report.)

System_CAPS_pubmethod Render(String, String)

Processes the report and renders it in the specified format.(Inherited from Report.)

System_CAPS_pubmethod Render(String, String, CreateStreamCallback, Warning[])

Processes the report and renders it in the specified format using a stream provided by a callback function.

System_CAPS_pubmethod Render(String, String, PageCountMode, CreateStreamCallback, Warning[])

Processes the report with a specified page count mode and renders it in the specified format using a stream provided by a callback function.

System_CAPS_pubmethod Render(String, String, PageCountMode, String, String, String, String[], Warning[])

Processes the report with a specified page count mode and renders it in the specified format.(Overrides Report.Render(String, String, PageCountMode, String, String, String, String[], Warning[]).)

System_CAPS_pubmethod Render(String, String, String, String, String, String[], Warning[])

Processes the report and renders it in the specified format.(Inherited from Report.)

System_CAPS_pubmethod SetBasePermissionsForSandboxAppDomain(PermissionSet)

Sets the base permissions for the sandboxed application domain with the supplied permission set.

System_CAPS_pubmethod SetParameters(IEnumerable<ReportParameter>)

Sets report parameter properties for the local report.(Overrides Report.SetParameters(IEnumerable<ReportParameter>).)

System_CAPS_pubmethod SetParameters(ReportParameter)

Sets report parameter properties for the report.(Inherited from Report.)

System_CAPS_pubmethod ToString()

(Inherited from Object.)

Events

Name Description
System_CAPS_pubevent SubreportProcessing

Occurs when a subreport is processed.

Explicit Interface Implementations

Name Description
System_CAPS_pubinterfaceSystem_CAPS_privmethod ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remarks

The LocalReport class represents reports that are processed and rendered locally without connecting to a report server. This class is the same object that is used by the ReportViewer control, but it also can be used independently as a nonvisual object that encapsulates the core functionality of the ReportViewer control.

The LocalReport object can open client report definition (RDLC) files from the file system or from embedded resources, or the RDLC file can be supplied to it as a Stream or a TextReader.

The LocalReport object does not have the ability to execute queries or fetch data; instead, data sources must be added to the DataSources collection property.

The LocalReport object supports report parameters, but does not support parameter prompts.

Examples

Legacy Code Example

In the following code example, a LocalReport object is used to load and export a report.

private void button1_Click(object sender, EventArgs e)
{

   Microsoft.Reporting.WinForms.LocalReport lr = new Microsoft.Reporting.WinForms.LocalReport();

   string deviceInfo =
     "<DeviceInfo>" +
     "<SimplePageHeaders>True</SimplePageHeaders>" + 
     "</DeviceInfo>";

   lr.ReportPath = @"C:\My Reports\Monthly Sales.rdlc";

   lr.DataSources.Add(new ReportDataSource("Sales", GetSalesData()));

   byte[] bytes = lr.Render("Excel", deviceInfo, out mimeType, 
     out encoding, out streamids, out warnings);

      using (FileStream fs = = new FileStream(@"c:\My Reports\Monthly Sales.xls", FileMode.Create))
      {
        fs.Write(bytes, 0, bytes.Length);
      }
}
Private Sub Button1_Click(ByVal sender As System.Object, _
   ByVal e As System.EventArgs) Handles Button1.Click
   Dim warnings As Warning() = Nothing
   Dim streamids As String() = Nothing
   Dim mimeType As String = Nothing
   Dim encoding As String = Nothing
   Dim extension As String = Nothing
   Dim deviceInfo as string
   Dim bytes As Byte()

   deviceInfo = "< deviceInfo ><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>"

   bytes = ReportViewer1.LocalReport.Render("Excel", Nothing, _
     mimeType,encoding, extension, streamids, warnings)

   Dim fs As New FileStream("c:\output.xls", FileMode.Create)
   fs.Write(bytes, 0, bytes.Length)

   MessageBox.Show("Report exported to output.xls", "Info")
End Sub

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Microsoft.Reporting.WinForms Namespace

Return to top