Partilhar via

Classe LocalReport

  • Artigo

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

Hierarquia de herança

Object
  Microsoft.Reporting.WebForms.Report
    Microsoft.Reporting.WebForms.LocalReport

Namespace:  Microsoft.Reporting.WebForms
Assembly:  Microsoft.ReportViewer.WebForms (em Microsoft.ReportViewer.WebForms.dll)

Sintaxe

'Declaração
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable

[SerializableAttribute]
public sealed class LocalReport : Report, 
    ISerializable, IDisposable

[SerializableAttribute]
public ref class LocalReport sealed : public Report, 
    ISerializable, IDisposable

[<Sealed>]
[<SerializableAttribute>]
type LocalReport =  
    class
        inherit Report
        interface ISerializable
        interface IDisposable
    end

public final class LocalReport extends Report implements ISerializable, IDisposable

O tipo LocalReport expõe os membros a seguir.

Construtores

  Nome Descrição
Método público LocalReport Initializes a new instance of the LocalReport class.

Superior

Propriedades

  Nome Descrição
Propriedade pública DataSources Gets a collection of data sources used by the report.
Propriedade pública DisplayName Gets or sets the display name of the report. (Herdado de Report.)
Propriedade pública EnableExternalImages Indicates whether the report can be rendered if it has external images.
Propriedade pública EnableHyperlinks Indicates whether the report can be rendered if it contains hyperlink actions.
Propriedade pública IsDrillthroughReport Indicates whether the report is a drillthrough report. (Herdado de Report.)
Propriedade pública IsReadyForRendering Gets a Boolean value that indicates whether a report definition and all parameters have been specified, and all data sources are ready for use. (Herdado de Report.)
Propriedade pública MapTileServerConfiguration Defines configuration settings for Microsoft Bing Maps SOAP Services that provides a tile background for map report items in the report.
Propriedade pública OriginalParametersToDrillthrough Returns the parameters passed from a parent report to this report, if it is a drillthrough report.
Propriedade pública ReportEmbeddedResource Gets or sets the name of the report embedded resource.
Propriedade pública ReportPath Gets or sets the local file system path of the local report.
Propriedade pública ShowDetailedSubreportMessages Gets or sets a Boolean value that indicates whether detailed messages should be displayed when an error occurs in a subreport.

Superior

Métodos

  Nome Descrição
Método público AddFullTrustModuleInSandboxAppDomain Adds the supplied assembly to the list of assemblies that run in full trust mode in the sandboxed application domain.
Método público AddTrustedCodeModuleInCurrentAppDomain Obsoleta. Adds the supplied assembly to the list of assemblies that are trusted to execute in the current AppDomain.
Método público Dispose Releases all resources that are used by the LocalReport object.
Método público Equals Determines whether the specified object is equal to the current object. (Herdado de Object.)
Método público ExecuteReportInCurrentAppDomain Obsoleta. Causes processing extensions and expressions in the report to be executed in the current AppDomain.
Método público ExecuteReportInSandboxAppDomain Obsoleta. Causes processing extensions and expressions to be run with limited permissions in an application domain.
Método público GetDataSourceNames Returns the names of all datasets used within the local report.
Método público GetDefaultPageSettings Gets the default page settings specified in the local report. (Substitui Report.GetDefaultPageSettings().)
Método público GetDocumentMap Returns the representation of the document map for the local report. (Herdado de Report.)
Método público GetHashCode Serves as the default hash function. (Herdado de Object.)
Método público GetParameters Returns report parameter properties for the report. (Substitui Report.GetParameters().)
Método público GetTotalPages() Returns the total number of soft pages in the report. (Herdado de Report.)
Método público GetTotalPages(PageCountMode%) Returns the total number of soft pages in the report and a PageCountMode enumeration value that indicates the current page count mode. (Substitui Report.GetTotalPages(PageCountMode%).)
Método público GetType Gets the Type of the current instance. (Herdado de Object.)
Método público ListRenderingExtensions Returns all available rendering extensions for the local report. (Substitui Report.ListRenderingExtensions().)
Método público LoadReportDefinition(TextReader) Loads a report definition from the local file system using a TextReader. (Substitui Report.LoadReportDefinition(TextReader).)
Método público LoadReportDefinition(Stream) Loads a report definition for processing using a Stream. (Herdado de Report.)
Método público LoadSubreportDefinition(String, Stream) Loads a subreport definition using a Stream.
Método público LoadSubreportDefinition(String, TextReader) Loads a subreport definition using a TextReader.
Método público Refresh Causes the local report to be rendered with new data. (Substitui Report.Refresh().)
Método público ReleaseSandboxAppDomain Causes the LocalReport object to release its reference to the sandboxed application domain immediately.
Método público Render(String) Processes the report and renders it in the specified format. (Herdado de Report.)
Método público Render(String, String) Processes the report and renders it in the specified format. (Herdado de Report.)
Método público Render(String, String, CreateStreamCallback, array<Warning[]%) Processes the report and renders it in the specified format using a stream provided by a callback function.
Método público Render(String, String, PageCountMode, CreateStreamCallback, array<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.
Método público Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) Processes the report and renders it in the specified format. (Herdado de Report.)
Método público Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%) Processes the report with a specified page count mode and renders it in the specified format. (Substitui Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%).)
Método público SetBasePermissionsForSandboxAppDomain Sets the base permissions for the sandboxed application domain with the supplied permission set.
Método público SetParameters(IEnumerable<ReportParameter>) Sets report parameter properties for the local report. (Substitui Report.SetParameters(IEnumerable<ReportParameter>).)
Método público SetParameters(ReportParameter) Sets report parameter properties for the report. (Herdado de Report.)
Método público ToString Returns a string that represents the current object. (Herdado de Object.)

Superior

Eventos

  Nome Descrição
Evento público SubreportProcessing Occurs when a subreport is processed.

Superior

Implementações explícitas da interface

  Nome Descrição
Implementação explícita da interfaceMétodo particular ISerializable.GetObjectData

Superior

Comentários

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 non-visual 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

Exemplos

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

protected void Button1_Click(object sender, EventArgs e)
{

   Microsoft.Reporting.WebForms.LocalReport lr = 
     new Microsoft.Reporting.WebForms.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);
      }
}

Protected Sub Button1_Click(ByVal sender As 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()

   Dim lr As New Microsoft.Reporting.WebForms.LocalReport

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

   lr.DataSources.Add(New ReportDataSource("Sales", GetSalesData()))

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

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

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

End Sub

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.Reporting.WebForms