ErrorWebPart 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在尝试加载或创建动态 WebPart 控件的新实例失败时,作为占位符插入网页。
public ref class ErrorWebPart : System::Web::UI::WebControls::WebParts::ProxyWebPart, System::Web::UI::WebControls::WebParts::ITrackingPersonalizable
public class ErrorWebPart : System.Web.UI.WebControls.WebParts.ProxyWebPart, System.Web.UI.WebControls.WebParts.ITrackingPersonalizable
type ErrorWebPart = class
inherit ProxyWebPart
interface ITrackingPersonalizable
Public Class ErrorWebPart
Inherits ProxyWebPart
Implements ITrackingPersonalizable
- 继承
- 实现
注解
ErrorWebPart类由 Web 部件控件集用作无法添加到页面的WebPart控件的占位符。 WebPartManager如果控件尝试在区域中加载或创建动态WebPart控件的新实例,但尝试由于某种原因而失败,WebPartManager则 调用 CreateErrorWebPart 方法,并插入控件ErrorWebPart来代替失败的控件。
插入 ErrorWebPart 控件是为了保留用户控件上可能存在的以前存在的个性化设置状态信息。 例如,假设有一个 WebPart 控件具有可个性化设置的属性,以便用户可以保存自己的邮政编码,然后控件可以在每次用户访问页面时自动显示该邮政编码的天气信息。 如果在某个时候天气控件出现问题,导致在特定请求期间无法加载该控件,但页面的其余部分确实加载成功,则下次保存页面个性化数据时,用户为该控件保存的自定义个性化数据将丢失。 通过插入 ErrorWebPart 控件来代替失败的控件,可以通知用户问题已发生,并为 Web 部件控件集提供一种机制,以保留失败控件上的用户个性化设置数据,直到问题得到纠正。
类 ErrorWebPart 派生自 ProxyWebPart 类,作为设计为其他类型的临时占位符的几种类型之一。 为了创建 类的实例,控件 WebPartManager 使用其公共 ErrorWebPart 构造函数。 构造函数要求将失败控件的几个详细信息传递给它,例如 ID、控件的原始类型 (如果失败的控件是包含在对象) 中的 GenericWebPart 服务器或用户控件,则为控件的源文件的原始路径 (如果失败的控件是用户控件) , 和 对象的 ID GenericWebPart (如果存在)。
类 ErrorWebPart 具有一个名为 的公共 ErrorMessage属性。 开发人员可以为此属性分配一个值,该值将在插入控件时显示在网页中。
类 ErrorWebPart 具有三个受保护的方法。 方法 AddAttributesToRender 从 ErrorStyle 包含无法加载的控件的区域的 对象 WebZone 中获取样式特征。 如果此对象中存在任何样式设置,方法会将这些样式设置应用于 控件 ErrorWebPart 。 方法 EndLoadPersonalization 在控件上 ErrorWebPart 设置几个重要的继承属性,以防止用户通过隐藏、最小化、编辑或导出控件或更改其 ChromeState 值来个性化控件。 最后, RenderContents 方法对 属性中 ErrorMessage 字符串的值进行编码,以防止呈现问题或脚本攻击。
继承者说明
实际将控件插入页面的条件 ErrorWebPart 相对较少,尽管类可以继承和扩展,但很少有开发人员会发现这一点非常重要。 可能需要扩展此类的一个原因是,如果要自定义控件的外观和行为 ErrorWebPart 。 例如,可以替代 EndLoadPersonalization() 方法,并在控件上 ErrorWebPart 设置除已设置的样式或其他属性之外的其他样式或其他属性。
若要要求控件 WebPartManager 使用自定义 ErrorWebPart 控件,还必须从 WebPartManager 类继承并重写其 CreateErrorWebPart(String, String, String, String, String) 方法。 在该方法中,应将方法 errorMessage 参数 ErrorMessage 的值分配给自定义 ErrorWebPart 控件的 属性,因为 WebPartManager 控件从其他几个位置调用此方法,并且通常会传入不同的错误消息值。
构造函数
| ErrorWebPart(String, String, String, String) |
初始化控件的新实例。 |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AllowClose |
获取或设置一个值,该值指示最终用户是否可以在网页上关闭 WebPart 控件。 (继承自 WebPart) |
| AllowConnect |
获取或设置一个值,该值指示 WebPart 控件是否允许其他控件与之形成连接。 (继承自 WebPart) |
| AllowEdit |
获取或设置一个值,该值指示最终用户是否可以通过一个或多个 WebPart 控件提供的用户界面 (UI) 修改 EditorPart 控件。 (继承自 WebPart) |
| AllowHide |
获取或设置一个值,该值指示是否允许最终用户隐藏 WebPart 控件。 (继承自 WebPart) |
| AllowMinimize |
获取或设置一个值,该值指示最终用户是否可以最小化 WebPart 控件。 (继承自 WebPart) |
| AllowZoneChange |
获取或设置一个值,该值指示用户是否可以在两个 WebPart 区域之间移动 WebPartZoneBase 控件。 (继承自 WebPart) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性(只用于呈现)的集合。 (继承自 WebControl) |
| AuthorizationFilter |
获取或设置一个任意字符串,以确定 WebPart 控件是否已被授权添加至页中。 (继承自 WebPart) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BackImageUrl |
获取或设置面板控件背景图像的 URL。 (继承自 Panel) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| CatalogIconImageUrl |
获取或设置图像的 URL,该图像在控件目录中表示一个 Web 部件控件。 (继承自 WebPart) |
| ChildControlsCreated |
获取一个值,该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ChromeState |
获取或设置部件控件是处于最小化状态还是正常状态。 (继承自 WebPart) |
| ChromeType |
获取或设置构成 Web 部件控件的框架的边框类型。 (继承自 WebPart) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值,该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| ConnectErrorMessage |
获取在连接过程中发生错误时要向用户显示的错误消息。 (继承自 WebPart) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象,该对象包含用户界面层次结构中指定服务器控件的子控件。 (继承自 Part) |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值,该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer,则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl,则获取对命名容器的引用。 (继承自 Control) |
| DefaultButton |
获取或设置 Panel 控件中包含的默认按钮的标识符。 (继承自 Panel) |
| Description |
获取或设置一条短语,该短语在部件控件的工具提示和目录中用来概述该部件控件的作用。 (继承自 WebPart) |
| DesignMode |
获取一个值,该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Direction |
获取或设置内容在控件中流动的水平方向。 (继承自 WebPart) |
| DisplayTitle |
获取一个字符串,其中包含在 WebPart 控件实例的标题栏中实际显示的完整标题文本。 (继承自 WebPart) |
| Enabled |
获取或设置一个值,该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值,该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| ErrorMessage |
获取或设置错误信息,该错误信息显示在网页中代替未能成功添加到该页的控件。 |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| ExportMode |
获取或设置是否可以导出所有、某些 WebPart 控件属性或不能导出该控件的任何属性。 (继承自 WebPart) |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色(通常是文本颜色)。 (继承自 WebControl) |
| GenericWebPartID |
从由代理 Web 部件控件所替换的一般 Web 部件控件获取 ID 属性的值。 (继承自 ProxyWebPart) |
| GroupingText |
获取或设置面板控件中包含的控件组的标题。 (继承自 Panel) |
| HasAttributes |
获取一个值,该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值,该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| HasSharedData |
获取一个值,该值指示 WebPart 控件是否有与之关联的任何共享个性化数据。 (继承自 WebPart) |
| HasUserData |
获取一个值,该值指示 WebPart 控件是否有与之关联的任何用户个性化数据。 (继承自 WebPart) |
| Height |
获取或设置区域的高度。 (继承自 WebPart) |
| HelpMode |
获取或设置用于显示 WebPart 控件的帮助内容的用户界面 (UI) 的类型。 (继承自 WebPart) |
| HelpUrl |
获取或设置指向 WebPart 控件的帮助文件的 URL。 (继承自 WebPart) |
| Hidden |
获取或设置一个值,该值指示是否在网页上显示 WebPart 控件。 (继承自 WebPart) |
| HorizontalAlign |
获取或设置面板内容的水平对齐方式。 (继承自 Panel) |
| ID |
获取或设置分配给 Web 部件控件的编程标识符。 (继承自 ProxyWebPart) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| ImportErrorMessage |
获取或设置在导入 WebPart 控件时发生错误的情况下将显示的错误消息。 (继承自 WebPart) |
| IsChildControlStateCleared |
获取一个值,该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsClosed |
获取一个值,该值指示 WebPart 控件当前在 Web 部件页上是否已关闭。 (继承自 WebPart) |
| IsEnabled |
获取一个值,该值指示是否启用控件。 (继承自 WebControl) |
| IsShared |
获取一个值,该值指示 WebPart 控件是否为共享控件,即对 Web 部件页的所有用户都可见。 (继承自 WebPart) |
| IsStandalone |
获取一个值,该值指示 WebPart 控件是否是独立控件(即该控件不包含在 WebPartZoneBase 区域中)。 (继承自 WebPart) |
| IsStatic |
获取一个值,该值指示 WebPart 控件是否为静态控件,即控件在 Web 部件页的标记中声明,而不是通过编程方式添加至页中。 (继承自 WebPart) |
| IsTrackingViewState |
获取一个值,用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值,该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值,该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| OriginalID |
获取由代理 Web 部件控件所替换的 Web 部件控件的 ID。 (继承自 ProxyWebPart) |
| OriginalPath |
获取要替换的用户控件的路径。 (继承自 ProxyWebPart) |
| OriginalTypeName |
获取由代理 Web 部件控件所替换的 Web 部件控件的 Type。 (继承自 ProxyWebPart) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值,该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| ScrollBars |
获取或设置 Panel 控件中滚动条的可见性和位置。 (继承自 Panel) |
| Site |
获取容器信息,该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| Subtitle |
获取一个字符串,该字符串与 Title 属性值连接即形成 WebPart 控件的完整标题。 (继承自 WebPart) |
| SupportsDisabledAttribute |
获取一个值,该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| Title |
获取或设置部件控件的标题。 (继承自 WebPart) |
| TitleIconImageUrl |
获取或设置图像的 URL,该图像用于在控件的标题栏中表示 Web 部件控件。 (继承自 WebPart) |
| TitleUrl |
获取或设置有关 WebPart 控件补充信息的 URL。 (继承自 WebPart) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| Verbs |
获取与 WebPart 控件关联的自定义谓词的集合。 (继承自 WebPart) |
| ViewState |
获取状态信息的字典,这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值,该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| WebBrowsableObject |
获取对 WebPart 控件的引用,以使该控件可由自定义 EditorPart 控件进行编辑。 (继承自 WebPart) |
| WebPartManager |
获取对与 WebPartManager 控件实例关联的 WebPart 控件的引用。 (继承自 WebPart) |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebPart) |
| Wrap |
获取或设置一个指示面板中的内容是否换行的值。 (继承自 Panel) |
| Zone |
获取当前包含 WebPartZoneBase 控件的 WebPart 区域。 (继承自 WebPart) |
| ZoneIndex |
获取 WebPart 控件在其区域内的索引位置。 (继承自 WebPart) |
方法
事件
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生;初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
| GetDefaultValues(INamingContainer) |
为指定数据控件获取默认值的集合。 |
| GetMetaTable(INamingContainer) |
为指定数据控件获取表元数据。 |
| SetMetaTable(INamingContainer, MetaTable) |
为指定数据控件设置表元数据。 |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
为指定数据控件设置表元数据和默认值映射。 |
| SetMetaTable(INamingContainer, MetaTable, Object) |
为指定数据控件设置表元数据和默认值映射。 |
| TryGetMetaTable(INamingContainer, MetaTable) |
确定表元数据是否可用。 |
| EnableDynamicData(INamingContainer, Type) |
为指定数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
为指定数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type, Object) |
为指定数据控件启用动态数据行为。 |