ReportViewer 类

项目
08/31/2012

包装用于**“ReportViewer”**控件的方法和属性。

继承层次结构

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.CompositeControl
        Microsoft.Reporting.WebForms.ReportViewer

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

语法

声明
Public Class ReportViewer _
    Inherits CompositeControl _
    Implements IScriptControl
用法
Dim instance As ReportViewer

public class ReportViewer : CompositeControl, 
    IScriptControl

public ref class ReportViewer : public CompositeControl, 
    IScriptControl

type ReportViewer =  
    class
        inherit CompositeControl
        interface IScriptControl
    end

public class ReportViewer extends CompositeControl implements IScriptControl

ReportViewer 类型公开以下成员。

构造函数

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

页首

属性

	名称	说明
	AccessKey	（从 WebControl 继承。）
	Adapter	（从 Control 继承。）
	AppRelativeTemplateSourceDirectory	（从 Control 继承。）
	AsyncRendering	获取或设置一个 Boolean 值，该值指示当加载网页时报表的呈现是否与网页的其余部分异步。
	Attributes	（从 WebControl 继承。）
	BackColor	获取或设置控件的报表区域的背景色。（覆盖 WebControl.BackColor。）
	BindingContainer	（从 Control 继承。）
	BorderColor	（从 WebControl 继承。）
	BorderStyle	（从 WebControl 继承。）
	BorderWidth	（从 WebControl 继承。）
	ChildControlsCreated	（从 Control 继承。）
	ClientID	（从 Control 继承。）
	ClientIDSeparator	（从 Control 继承。）
	Context	（从 Control 继承。）
	Controls	（从 CompositeControl 继承。）
	ControlStyle	（从 WebControl 继承。）
	ControlStyleCreated	（从 WebControl 继承。）
	CssClass	（从 WebControl 继承。）
	CurrentPage	获取或设置“ReportViewer”控件的活动报表的当前页。
	DesignMode	（从 Control 继承。）
	DocumentMapCollapsed	获取或设置文档结构图的折叠状态。
	DocumentMapWidth	获取或设置文档结构图的宽度。
	Enabled	（从 WebControl 继承。）
	EnableTheming	（从 WebControl 继承。）
	EnableViewState	（从 Control 继承。）
	Events	（从 Control 继承。）
	ExportContentDisposition	获取或设置一个指示内容应以内联方式存在还是作为附件存在的值。
	Font	（从 WebControl 继承。）
	ForeColor	（从 WebControl 继承。）
	HasAttributes	（从 WebControl 继承。）
	HasChildViewState	（从 Control 继承。）
	Height	获取或设置控件的高度。（覆盖 WebControl.Height。）
	HyperlinkTarget	获取或设置单击报表中的超链接时返回的网页内容的目标窗口或框架。
	ID	指定控件的 ID。（覆盖 Control.ID。）
	IdSeparator	（从 Control 继承。）
	InteractiveDeviceInfos	获取“ReportViewer”控件用于将报表区域中的报表呈现为 HTML 的 DeviceInfoCollection 对象。
	InteractivityPostBackMode	获取或设置一个 InteractivityPostBackMode 值，该值指示 ReportViewer 控件的回发模式。
	InternalBorderColor	获取或设置控件的内部边框颜色。
	InternalBorderStyle	获取或设置控件的内部边框样式。
	InternalBorderWidth	获取或设置控件的内部边框宽度。
	IsChildControlStateCleared	（从 Control 继承。）
	IsEnabled	（从 WebControl 继承。）
	IsTrackingViewState	（从 Control 继承。）
	IsViewStateEnabled	（从 Control 继承。）
	KeepSessionAlive	获取或设置一个 Boolean 值，该值指示当网页显示在浏览器中时是否阻止用户会话过期。
	LinkActiveColor	获取或设置控件中的活动链接的颜色。
	LinkActiveHoverColor	获取或设置当鼠标指针处于控件中的活动链接上时该链接的颜色。
	LinkDisabledColor	获取或设置控件中的禁用链接的颜色。
	LoadViewStateByID	（从 Control 继承。）
	LocalReport	获取当 ReportViewer 控件的 ProcessingMode 设置为 Local 时使用的 Report 类的实例。
	NamingContainer	（从 Control 继承。）
	Page	（从 Control 继承。）
	PageCountMode	获取或设置一个 PageCountMode 枚举值，该值指示当在报表区域中呈现报表时使用的默认页计数模式。
	Parent	（从 Control 继承。）
	ProcessingMode	获取或设置“ReportViewer”控件的处理模式。
	PromptAreaCollapsed	获取或设置参数提示区域或凭据提示区域的折叠状态。
	ReportAreaContentType	获取一个 ReportAreaContent 对象，该对象表示报表区域的当前内容类型。
	SearchState	获取当前报表搜索操作的搜索文本和开始页。
	ServerReport	获取当 ReportViewer 控件的 ProcessingMode 设置为 Remote 时使用的 Report 类的实例。
	ShowBackButton	获取或设置一个指示“后退”按钮在工具栏上是否可见的值。
	ShowCredentialPrompts	获取或设置一个值，该值指示是否显示要求提供用户凭据的提示。
	ShowDocumentMapButton	获取或设置一个值，该值指示用于显示和折叠文档结构图的按钮是否在拆分栏上可见。
	ShowExportControls	获取或设置一个指示“Export”控件在工具栏上是否可见的值。
	ShowFindControls	获取或设置一个指示“查找”文本框在工具栏上是否可见的值。
	ShowPageNavigationControls	获取或设置一个指示页导航控件在工具栏上是否可见的值。
	ShowParameterPrompts	获取或设置一个指示是否显示参数提示的值。
	ShowPrintButton	获取或设置一个指示“打印”按钮在工具栏上是否可见的值。
	ShowPromptAreaButton	获取或设置一个值，该值指示用于显示和折叠提示区域的按钮是否在拆分栏上可见。
	ShowRefreshButton	获取或设置一个指示“刷新”按钮是否可见的值。
	ShowReportBody	获取或设置一个指示表体在控件上是否可见的值。
	ShowToolBar	获取或设置一个指示工具栏在控件上是否可见的值。
	ShowWaitControlCancelLink	获取或设置一个 Boolean 值，该值控制是否在等待控件中显示“取消”链接。
	ShowZoomControl	获取或设置一个指示“缩放”列表框是否可见的值。
	Site	（从 Control 继承。）
	SizeToReportContent	获取或设置一个值，该值指示“ReportViewer”控件是否应自动调整大小以容纳报表内容。
	SkinID	（从 WebControl 继承。）
	SplitterBackColor	获取或设置文档结构图拆分栏和提示区域拆分栏的背景色。
	Style	（从 WebControl 继承。）
	TabIndex	（从 WebControl 继承。）
	TagKey	基础结构。获取与 “ReportViewer” 控件相关的 HtmlTextWriterTag 值。（覆盖 WebControl.TagKey。）
	TagName	（从 WebControl 继承。）
	TemplateControl	（从 Control 继承。）
	TemplateSourceDirectory	（从 Control 继承。）
	ToolBarItemBorderColor	获取或设置工具栏上某一项的边框颜色。
	ToolBarItemBorderStyle	获取或设置工具栏上某一项的边框样式。
	ToolBarItemBorderWidth	获取或设置工具栏项的边框宽度。
	ToolBarItemHoverBackColor	获取或设置当鼠标指针位于工具栏项上时该项的背景颜色。
	ToolBarItemPressedBorderColor	已过时。此属性不再适用，它存在的目的是向后兼容。“ReportViewer” 控件不再使用按下的按钮。
	ToolBarItemPressedBorderStyle	已过时。此属性不再适用，它存在的目的是向后兼容。“ReportViewer” 控件不再使用按下的按钮。
	ToolBarItemPressedBorderWidth	已过时。此属性不再适用，它存在的目的是向后兼容。“ReportViewer” 控件不再使用按下的按钮。
	ToolBarItemPressedHoverBackColor	已过时。此属性不再适用，它存在的目的是向后兼容。“ReportViewer” 控件不再使用按下的按钮。
	ToolTip	（从 WebControl 继承。）
	UniqueID	（从 Control 继承。）
	ViewState	（从 Control 继承。）
	ViewStateIgnoresCase	（从 Control 继承。）
	Visible	（从 Control 继承。）
	WaitControlDisplayAfter	获取或设置当加载报表时在向用户显示等待控件之前的延迟（以毫秒为单位）。
	WaitMessageFont	获取在执行报表时显示的消息所采用的字体。
	Width	获取或设置控件的宽度。（覆盖 WebControl.Width。）
	ZoomMode	获取或设置控件的缩放模式。
	ZoomPercent	获取或设置显示报表时要使用的缩放百分比。

页首

方法

	名称	说明
	AddAttributesToRender	（从 WebControl 继承。）
	AddedControl	（从 Control 继承。）
	AddParsedSubObject	（从 Control 继承。）
	ApplyStyle	（从 WebControl 继承。）
	ApplyStyleSheetSkin	（从 Control 继承。）
	BuildProfileTree	（从 Control 继承。）
	ClearChildControlState	（从 Control 继承。）
	ClearChildState	（从 Control 继承。）
	ClearChildViewState	（从 Control 继承。）
	CopyBaseAttributes	（从 WebControl 继承。）
	CreateChildControls	基础结构。由 ASP.NET 页面 framework 调用以通知 “ReportViewer” 控件创建它在发回或绘制的准备中所包含的任何子控件。（覆盖 Control.CreateChildControls()。）
	CreateControlCollection	（从 Control 继承。）
	CreateControlStyle	基础结构。创建由控件在内部用于实现所有样式相关属性的样式对象。（覆盖 WebControl.CreateControlStyle()。）
	DataBind()	（从 CompositeControl 继承。）
	DataBind(Boolean)	（从 Control 继承。）
	DataBindChildren	（从 Control 继承。）
	Dispose	基础结构。释放由 ReportViewer 类使用的所有资源。（覆盖 Control.Dispose()。）
	EnsureChildControls	（从 Control 继承。）
	EnsureID	（从 Control 继承。）
	Equals	（从 Object 继承。）
	Finalize	（从 Object 继承。）
	Find	从指定的页码开始搜索报表区域中的报表，以查找指定的文本字符串。
	FindControl(String)	（从 Control 继承。）
	FindControl(String, Int32)	（从 Control 继承。）
	Focus	（从 Control 继承。）
	GetDesignModeState	（从 Control 继承。）
	GetHashCode	（从 Object 继承。）
	GetPageSettings	返回“ReportViewer”控件中用于打印当前报表的页设置。
	GetType	（从 Object 继承。）
	HasControls	（从 Control 继承。）
	HasEvents	（从 Control 继承。）
	IsLiteralContent	（从 Control 继承。）
	JumpToBookmark	将报表的焦点移至指定的书签。
	JumpToDocumentMapId	将文档结构图的焦点移至指定的节点。
	LoadControlState	（从 Control 继承。）
	LoadViewState	基础结构。从用 SaveViewState 方法保存的之前的请求中还原视图状态信息。（覆盖 WebControl.LoadViewState(Object)。）
	MapPathSecure	（从 Control 继承。）
	MemberwiseClone	（从 Object 继承。）
	MergeStyle	（从 WebControl 继承。）
	OnBubbleEvent	（从 Control 继承。）
	OnDataBinding	（从 Control 继承。）
	OnInit	基础结构。引发 Init 事件。（覆盖 Control.OnInit(EventArgs)。）
	OnLoad	（从 Control 继承。）
	OnPreRender	基础结构。引发 PreRender 事件。（覆盖 Control.OnPreRender(EventArgs)。）
	OnUnload	（从 Control 继承。）
	OpenFile	（从 Control 继承。）
	PerformBack	通过“ReportViewer”控件从钻取报表向回导航至父报表。
	RaiseBubbleEvent	（从 Control 继承。）
	RecreateChildControls	（从 CompositeControl 继承。）
	RegisterPostBackControl	向“ReportViewer”控件注册指定的控件。“ReportViewer” 控件在注册的控件导致回发时显示等待控件。
	RemovedControl	（从 Control 继承。）
	Render	基础结构。将控件呈现给指定的 HTML 编写器。（覆盖 CompositeControl.Render(HtmlTextWriter)。）
	RenderBeginTag	（从 WebControl 继承。）
	RenderChildren	（从 Control 继承。）
	RenderContents	（从 WebControl 继承。）
	RenderControl(HtmlTextWriter)	（从 Control 继承。）
	RenderControl(HtmlTextWriter, ControlAdapter)	（从 Control 继承。）
	RenderEndTag	（从 WebControl 继承。）
	Reset	将控件重置为其默认值。
	ResetPageSettings	将“ReportViewer”控件中当前报表的页设置还原为报表定义中的设置。
	ResolveAdapter	（从 Control 继承。）
	ResolveClientUrl	（从 Control 继承。）
	ResolveUrl	（从 Control 继承。）
	SaveControlState	（从 Control 继承。）
	SaveViewState	基础结构。保存 “ReportViewer” 控件的视图状态信息。（覆盖 WebControl.SaveViewState()。）
	SetDesignModeState	（从 Control 继承。）
	SetPageSettings	设置用于打印“ReportViewer”控件中当前报表的页设置。
	SetRenderMethodDelegate	（从 Control 继承。）
	ToString	（从 Object 继承。）
	TrackViewState	（从 WebControl 继承。）

页首

事件

	名称	说明
	Back	当用户从钻取报表向回导航至父报表时发生。
	BookmarkNavigation	当用户浏览至报表中的书签时发生。
	DataBinding	（从 Control 继承。）
	Disposed	（从 Control 继承。）
	DocumentMapNavigation	当选择了文档结构图节点时发生。
	Drillthrough	当选择了钻取项时发生。
	Init	（从 Control 继承。）
	Load	（从 Control 继承。）
	PageNavigation	当用户移至报表中的其他页时发生。
	PreRender	（从 Control 继承。）
	ReportError	在报表中发现错误时发生。
	ReportRefresh	当刷新报表时发生。
	Search	当单击“查找”或“查找下一个”按钮或以编程方式调用搜索操作时发生。
	Sort	当用户激活报表数据的排序时发生。
	SubmittingDataSourceCredentials	当用户使用数据源提示区域提交新数据源凭据时发生。
	SubmittingParameterValues	当报表参数值提交到报表服务器时发生。
	Toggle	当用户切换报表中的项的可见性时发生。
	Unload	（从 Control 继承。）

页首

字段

	名称	说明
	MaximumPageCount	一个常数，该常数表示当前页计数模式为 Estimate 时报表中的最大页数。

页首

显式接口实现

	名称	说明
	IScriptControl.GetScriptDescriptors	获取表示 ECMAScript (JavaScript) 客户端组件的脚本说明符的集合。
	IScriptControl.GetScriptReferences	获取用于定义控件需要的脚本资源的 ScriptReference 对象的集合。
	IParserAccessor.AddParsedSubObject	（从 Control 继承。）
	IControlBuilderAccessor.ControlBuilder	（从 Control 继承。）
	IDataBindingsAccessor.DataBindings	（从 Control 继承。）
	IExpressionsAccessor.Expressions	（从 Control 继承。）
	IAttributeAccessor.GetAttribute	（从 WebControl 继承。）
	IControlDesignerAccessor.GetDesignModeState	（从 Control 继承。）
	IDataBindingsAccessor.HasDataBindings	（从 Control 继承。）
	IExpressionsAccessor.HasExpressions	（从 Control 继承。）
	ICompositeControlDesignerAccessor.RecreateChildControls	（从 CompositeControl 继承。）
	IAttributeAccessor.SetAttribute	（从 WebControl 继承。）
	IControlDesignerAccessor.SetDesignModeState	（从 Control 继承。）
	IControlDesignerAccessor.SetOwnerControl	（从 Control 继承。）
	IControlDesignerAccessor.UserData	（从 Control 继承。）

页首

注释

该控件显示报表及其关联的用户界面。

该控件可以在本地处理模式或远程处理模式下工作。在本地处理模式中，控件在本地处理和呈现报表。在远程处理模式中，报表在报表服务器上处理，而在本地显示。远程处理模式需要报表服务器的 Microsoft SQL Server 2008 或更高版本实例。

注意
有关在 Web 场中或在没有会话状态的情况下使用“ReportViewer”Web 服务器控件的更多信息，请参见 ReportViewer 的 Web.config 设置。

有关使用客户端 ReportViewer 控件以及使用客户端 API 的信息，请参见 ReportViewer 类。

线程安全

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

请参阅

参考

Microsoft.Reporting.WebForms 命名空间

通过

ReportViewer 类

继承层次结构

语法

构造函数

属性

方法

事件

字段

显式接口实现

注释

线程安全

请参阅

参考

其他资源