ProxyWebPart 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示 Web 部件控件的基类,在特定情况下这些控件必须替换页面上的其他 Web 部件控件。
public ref class ProxyWebPart abstract : System::Web::UI::WebControls::WebParts::WebPart
public abstract class ProxyWebPart : System.Web.UI.WebControls.WebParts.WebPart
type ProxyWebPart = class
inherit WebPart
Public MustInherit Class ProxyWebPart
Inherits WebPart
- 继承
- 派生
注解
ProxyWebPart 是一组 Web 部件控件(如 UnauthorizedWebPart 和 ErrorWebPart)的基类,可用作页面上其他 Web 部件控件的占位符。 通常,当发生某种类型的错误或故障时, ProxyWebPart 控件将替换另一个 Web 部件控件。 例如,当用户无权在页面上查看 Web 部件控件时,预期的 Web 部件控件将替换为控件 UnauthorizedWebPart 。 当无法加载 Web 部件控件或无法创建它的新实例时,原始 Web 部件控件将替换为该 ErrorWebPart 控件。 如果预期的 Web 部件控件稍后可供用户使用,它将还原到页面,并且将从 类派 ProxyWebPart 生的对象删除。
类 ProxyWebPart 不保存视图状态或控件状态。 如果 Web 部件控件被对象替换 ProxyWebPart ,然后变为可用,则其视图状态和控件状态将为空。
对象 ProxyWebPart 保留它替换的 Web 部件控件的个性化设置数据。 如果原始 Web 部件控件可用,则其个性化设置数据将还原。
当 WebPartManager 控件保存个性化设置数据时,它不会保存 对象的属性 ProxyWebPart 。 而是保存对象替换的控件 ProxyWebPart 的属性。 如果原始 Web 部件控件可用,该 WebPartManager 控件将自动加载它。
对象 WebPartCollection 包含 ProxyWebPart 对象。 可以从 属性或 属性检索 OriginalID 目标 Web 部件控件的 GenericWebPartID ID。
ProxyWebPart如果 对象替换了 Web 部件控件,该控件是 Web 部件连接的提供程序或使用者,则连接不会激活,但不会被删除。 如果原始 Web 部件控件变为可用,则会重新激活连接。
构造函数
ProxyWebPart(String, String, String, String) |
在必须替换动态 Web 部件控件时,初始化 ProxyWebPart 类的新实例。 |
ProxyWebPart(WebPart) |
在必须替换静态 Web 部件控件(服务器或用户控件)时,初始化 ProxyWebPart 类的新实例。 |
属性
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) |
Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
ExportMode |
获取或设置是否可以导出所有、某些 WebPart 控件属性或不能导出该控件的任何属性。 (继承自 WebPart) |
Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
ForeColor |
获取或设置 Web 服务器控件的前景色(通常是文本颜色)。 (继承自 WebControl) |
GenericWebPartID |
从由代理 Web 部件控件所替换的一般 Web 部件控件获取 ID 属性的值。 |
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 部件控件的编程标识符。 |
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。 |
OriginalPath |
获取要替换的用户控件的路径。 |
OriginalTypeName |
获取由代理 Web 部件控件所替换的 Web 部件控件的 Type。 |
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) |
为指定数据控件启用动态数据行为。 |