LocalReport 类

项目
05/09/2011

表示不用连接到报表服务器而在本地处理和呈现的报表。

继承层次结构

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

命名空间： Microsoft.Reporting.WinForms
程序集： Microsoft.ReportViewer.WinForms（在 Microsoft.ReportViewer.WinForms.dll 中）

语法

声明
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable
用法
Dim instance As LocalReport

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

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

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

public final class LocalReport extends Report implements ISerializable, IDisposable

LocalReport 类型公开以下成员。

构造函数

	名称	说明
	LocalReport	初始化 LocalReport 类的一个新实例。

页首

属性

	名称	说明
	DataSources	获取报表使用的数据源集合。
	DisplayName	获取或设置报表的显示名称。（从 Report 继承。）
	EnableExternalImages	指示在报表包含外部图像时是否可以呈现。
	EnableHyperlinks	指示在报表包含超链接操作时是否可以呈现。
	IsDrillthroughReport	指示该报表是否为钻取报表。（从 Report 继承。）
	IsReadyForRendering	获取一个 Boolean 值，该值指示是否已指定报表定义及所有必需参数，以及是否所有数据源已经可供使用。（从 Report 继承。）
	OriginalParametersToDrillthrough	返回从父报表传递到此报表（如果它是钻取报表）的参数。
	ReportEmbeddedResource	获取或设置嵌入报表的资源的名称。
	ReportPath	获取或设置本地报表的文件系统路径。
	ShowDetailedSubreportMessages	获取或设置一个 boolean 值，该值指示当子报表中出错时是否应显示详细消息。

页首

方法

	名称	说明
	AddFullTrustModuleInSandboxAppDomain	将提供的程序集添加到在沙盒应用程序域中以完全信任模式运行的程序集列表。
	AddTrustedCodeModuleInCurrentAppDomain	已过时。将提供的程序集添加至可以在当前 AppDomain 中执行的程序集列表。
	Dispose	释放由 LocalReport 对象使用的所有资源。
	Equals	（从 Object 继承。）
	ExecuteReportInCurrentAppDomain	已过时。导致在当前 AppDomain 中执行报表中的处理扩展插件和表达式。
	ExecuteReportInSandboxAppDomain	已过时。导致处理扩展插件和表达式以有限权限在应用程序域中运行。
	Finalize	（从 Object 继承。）
	GetDataSourceNames	返回本地报表中使用的所有数据集的名称。
	GetDefaultPageSettings	获取在本地报表中指定的默认页设置。（覆盖 Report.GetDefaultPageSettings()。）
	GetDocumentMap	返回本地报表的文档结构图的表示形式。（从 Report 继承。）
	GetHashCode	（从 Object 继承。）
	GetParameters	返回报表的报表参数属性。（覆盖 Report.GetParameters()。）
	GetTotalPages()	返回报表中的软页总数。（从 Report 继承。）
	GetTotalPages(PageCountMode%)	返回报表中的软页总数以及用于指示当前页计数模式的 PageCountMode 枚举值。（覆盖 Report.GetTotalPages(PageCountMode%)。）
	GetType	（从 Object 继承。）
	ListRenderingExtensions	返回本地报表的所有可用的呈现扩展插件。（覆盖 Report.ListRenderingExtensions()。）
	LoadReportDefinition(TextReader)	使用 TextReader 从本地文件系统加载报表定义。（覆盖 Report.LoadReportDefinition(TextReader)。）
	LoadReportDefinition(Stream)	使用 Stream 加载要处理的报表定义。（从 Report 继承。）
	LoadSubreportDefinition(String, Stream)	使用 Stream 加载子报表定义。
	LoadSubreportDefinition(String, TextReader)	使用 TextReader 加载子报表定义。
	MemberwiseClone	（从 Object 继承。）
	Refresh	导致用新数据呈现本地报表。（覆盖 Report.Refresh()。）
	ReleaseSandboxAppDomain	使 LocalReport 对象立即释放其对沙盒应用程序域的引用。
	Render(String)	处理报表并以指定的格式呈现该报表。（从 Report 继承。）
	Render(String, String)	处理报表并以指定的格式呈现该报表。（从 Report 继承。）
	Render(String, String, CreateStreamCallback, array<Warning[]%)	处理报表，并使用回调函数提供的流以指定的格式呈现报表。
	Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%)	使用指定页计数模式处理报表，并使用回调函数提供的流以指定格式呈现报表。
	Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%)	处理报表并以指定的格式呈现该报表。（从 Report 继承。）
	Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%)	以指定页计数模式处理报表，并以指定格式呈现报表。（覆盖 Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%)。）
	SetBasePermissionsForSandboxAppDomain	使用提供的权限集设置沙盒应用程序域的基本权限。
	SetParameters(IEnumerable<ReportParameter>)	设置本地报表的报表参数属性。（覆盖 Report.SetParameters(IEnumerable<ReportParameter>)。）
	SetParameters(ReportParameter)	设置报表的报表参数属性。（从 Report 继承。）
	ToString	（从 Object 继承。）

页首

事件

	名称	说明
	SubreportProcessing	在处理子报表时发生。

页首

显式接口实现

	名称	说明
	ISerializable.GetObjectData

页首

注释

LocalReport 类表示不用连接到报表服务器而在本地处理和呈现的报表。此类是 ReportViewer 控件使用的对象，但还可以独立用作包装 ReportViewer 控件的核心功能的非可视对象。

LocalReport 对象可以打开文件系统中或嵌入资源中的客户端报表定义 (RDLC) 文件，或者 RDLC 文件可以作为 Stream 或 TextReader 提供给该对象。

LocalReport 对象无法执行查询或提取数据；数据源必须添加到 DataSources 集合属性。

LocalReport 对象支持报表参数，但是不支持参数提示。

示例

在下面的代码示例中，使用一个 LocalReport 对象加载和导出报表。

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

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared）成员都是线程安全的。不保证所有实例成员都是线程安全的。

请参阅

参考

Microsoft.Reporting.WinForms 命名空间

通过

LocalReport 类

继承层次结构

语法

构造函数

属性

方法

事件

显式接口实现

注释

示例

线程安全

请参阅

参考

其他资源