ErrorWebPart 类
定义
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 无法添加到页面的控件的占位符。The ErrorWebPart class is used by the Web Parts control set as a placeholder for a WebPart control that could not be added to the page. 如果 WebPartManager 控件尝试在区域中加载或创建动态控件的新实例 WebPart ,并且由于某种原因尝试失败,则会 WebPartManager 调用 CreateErrorWebPart 方法,并插入 ErrorWebPart 控件来代替失败的控件。If the WebPartManager control attempts to load or create a new instance of a dynamic WebPart control in a zone, and the attempt fails for some reason, the WebPartManager then calls the CreateErrorWebPart method, and inserts an ErrorWebPart control in place of the control that failed.
ErrorWebPart插入控件以保留以前存在的、用户控件上可能已存在的个性化设置状态信息。The ErrorWebPart control is inserted to preserve previously existing personalization state information that might have existed on a control for users. 例如,假设有一个 WebPart 具有可个性化属性的控件,以便用户可以保存其自己的邮政编码,然后在每次用户访问该页面时,该控件都可以自动显示该邮政编码的天气信息。For example, suppose there is a WebPart control that has a personalizable property, so that users can save their own ZIP Code, and then the control can automatically display weather information for that ZIP Code each time the user visits the page. 如果天气控件出现问题,使其无法在特定请求过程中加载,但页面的其余部分加载成功,则用户为该控件保存的自定义个性化设置数据将在下一次保存页面的个性化数据时丢失。If at some point a problem occurs with the weather control so that it cannot be loaded during a specific request, and yet the rest of the page does load successfully, the custom personalization data that a user has saved for that control would be lost the next time the personalization data for the page is saved. 通过插入 ErrorWebPart 控件来代替失败的控件,你可以通知用户出现了问题,还提供了一种机制,以便 Web 部件控件集在失败的控件上保留用户的个性化数据,直到问题得以更正。By inserting the ErrorWebPart control in place of the failed control, you can notify the user that a problem has occurred, and also provide a mechanism for the Web Parts control set to preserve the user's personalization data on the failed control until the problem can be corrected.
ErrorWebPart类派生自 ProxyWebPart 类,作为一些设计为其他类型的临时占位符的类型。The ErrorWebPart class derives from the ProxyWebPart class, as one of several types designed to be temporary placeholders for other types. 若要创建类的实例,控件将 WebPartManager 使用其公共 ErrorWebPart 构造函数。To create an instance of the class, the WebPartManager control uses its public ErrorWebPart constructor. 构造函数要求向其传递失败的控件的几个详细信息,例如 ID、控件的原始类型 (如果失败的控件是包装在对象中的服务器控件或用户控件 GenericWebPart) 、控件的源文件的原始路径 (如果失败的控件是用户控件) ,以及对象的 ID ( GenericWebPart 如果存在)。The constructor requires several details of the failed control to be passed to it, such as the ID, the original type of the control (if the failed control is a server or user control wrapped in a GenericWebPart object), the original path to the source file for the control (if the failed control is a user control), and the ID of a GenericWebPart object if present.
ErrorWebPart类具有一个名为的公共属性 ErrorMessage 。The ErrorWebPart class has a single public property called ErrorMessage. 开发人员可以为此属性分配一个值,该值将在插入控件时显示在网页中。Developers can assign a value to this property that will be displayed in a Web page when the control is inserted.
ErrorWebPart类有三个受保护的方法。The ErrorWebPart class has three protected methods. AddAttributesToRender方法从 ErrorStyle WebZone 包含无法加载的控件的区域的对象中提取样式特征。The AddAttributesToRender method takes style characteristics from the ErrorStyle object for the WebZone zone that contains the control that failed to load. 如果此对象中存在任何样式设置,则方法会将这些设置应用于 ErrorWebPart 控件。If any style settings exist in this object, the method applies them to the ErrorWebPart control. EndLoadPersonalization方法设置控件上几个重要的继承属性 ErrorWebPart ,以防止用户通过隐藏、最小化、编辑或导出控件或更改其值来对控件进行个性化设置 ChromeState 。The EndLoadPersonalization method sets several important inherited properties on the ErrorWebPart control, to prevent users from personalizing the control by hiding, minimizing, editing, or exporting it, or changing its ChromeState value. 最后, RenderContents 方法对属性中字符串的值 ErrorMessage 进行编码,以防止呈现问题或脚本攻击。Finally, the RenderContents method encodes the value of the string in the ErrorMessage property, to prevent rendering problems or scripting attacks.
继承者说明
ErrorWebPart控件实际插入页面的条件相对较少,尽管类可以继承自和扩展,但很少有开发人员会发现这是非常重要的。The conditions in which an ErrorWebPart control is actually inserted into a page are relatively rare, and although the class can be inherited from and extended, few developers will find this to be of great importance. 要扩展此类的一个原因是,如果要自定义控件的外观和行为,则为 ErrorWebPart 。One reason you might want to extend this class is if you want to customize the appearance and behavior of the ErrorWebPart control. 例如,可以重写 EndLoadPersonalization() 方法,并在控件上设置其他样式或其他属性 ErrorWebPart ,而不是已设置的属性。For example, you could override the EndLoadPersonalization() method, and set additional style or other properties on the ErrorWebPart control, beyond those that are already set.
若要要求 WebPartManager 控件使用自定义 ErrorWebPart 控件,还必须从 WebPartManager 类继承并重写其 CreateErrorWebPart(String, String, String, String, String) 方法。To require the WebPartManager control to use a custom ErrorWebPart control, you must also inherit from the WebPartManager class and override its CreateErrorWebPart(String, String, String, String, String) method. 在该方法中,应将方法参数的值分配 errorMessage 给 ErrorMessage 自定义控件的属性 ErrorWebPart ,因为该 WebPartManager 控件从多个其他位置调用此方法,并且通常会传入不同的错误消息值。In that method, you should assign the value of the method's errorMessage parameter to the ErrorMessage property of your custom ErrorWebPart control, because the WebPartManager control calls this method from several other places, and often passes in a different error message value.
构造函数
| ErrorWebPart(String, String, String, String) |
初始化控件的新实例。Initializes a new instance of the control. |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。Gets or sets the access key that allows you to quickly navigate to the Web server control. (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。Gets the browser-specific adapter for the control. (继承自 Control) |
| AllowClose |
获取或设置一个值,该值指示最终用户是否可以在网页上关闭 WebPart 控件。Gets or sets a value indicating whether an end user can close a WebPart control on a Web page. (继承自 WebPart) |
| AllowConnect |
获取或设置一个值,该值指示 WebPart 控件是否允许其他控件与之形成连接。Gets or sets a value that indicates whether the WebPart control allows other controls to form connections with it. (继承自 WebPart) |
| AllowEdit |
获取或设置一个值,该值指示最终用户是否可以通过一个或多个 WebPart 控件提供的用户界面 (UI) 修改 EditorPart 控件。Gets or sets a value indicating whether an end user can modify a WebPart control through the user interface (UI) provided by one or more EditorPart controls. (继承自 WebPart) |
| AllowHide |
获取或设置一个值,该值指示是否允许最终用户隐藏 WebPart 控件。Gets or sets a value indicating whether end users are allowed to hide a WebPart control. (继承自 WebPart) |
| AllowMinimize |
获取或设置一个值,该值指示最终用户是否可以最小化 WebPart 控件。Gets or sets a value indicating whether end users can minimize a WebPart control. (继承自 WebPart) |
| AllowZoneChange |
获取或设置一个值,该值指示用户是否可以在两个 WebPart 区域之间移动 WebPartZoneBase 控件。Gets or sets a value indicating whether a user can move a WebPart control between WebPartZoneBase zones. (继承自 WebPart) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性(只用于呈现)的集合。Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control. (继承自 WebControl) |
| AuthorizationFilter |
获取或设置一个任意字符串,以确定 WebPart 控件是否已被授权添加至页中。Gets or sets an arbitrary string to determine whether a WebPart control is authorized to be added to a page. (继承自 WebPart) |
| BackColor |
获取或设置 Web 服务器控件的背景色。Gets or sets the background color of the Web server control. (继承自 WebControl) |
| BackImageUrl |
获取或设置面板控件背景图像的 URL。Gets or sets the URL of the background image for the panel control. (继承自 Panel) |
| BindingContainer |
获取包含该控件的数据绑定的控件。Gets the control that contains this control's data binding. (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。Gets or sets the border color of the Web control. (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。Gets or sets the border style of the Web server control. (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。Gets or sets the border width of the Web server control. (继承自 WebControl) |
| CatalogIconImageUrl |
获取或设置图像的 URL,该图像在控件目录中表示一个 Web 部件控件。Gets or sets the URL to an image that represents a Web Parts control in a catalog of controls. (继承自 WebPart) |
| ChildControlsCreated |
获取一个值,该值指示是否已创建服务器控件的子控件。Gets a value that indicates whether the server control's child controls have been created. (继承自 Control) |
| ChromeState |
获取或设置部件控件是处于最小化状态还是正常状态。Gets or sets whether a part control is in a minimized or normal state. (继承自 WebPart) |
| ChromeType |
获取或设置构成 Web 部件控件的框架的边框类型。Gets or sets the type of border that frames a Web Parts control. (继承自 WebPart) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。Gets the control ID for HTML markup that is generated by ASP.NET. (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。Gets or sets the algorithm that is used to generate the value of the ClientID property. (继承自 Control) |
| ClientIDSeparator |
获取一个字符值,该值表示 ClientID 属性中使用的分隔符字符。Gets a character value representing the separator character used in the ClientID property. (继承自 Control) |
| ConnectErrorMessage |
获取在连接过程中发生错误时要向用户显示的错误消息。Gets an error message to display to users if errors occur during the connection process. (继承自 WebPart) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。Gets the HttpContext object associated with the server control for the current Web request. (继承自 Control) |
| Controls |
获取 ControlCollection 对象,该对象包含用户界面层次结构中指定服务器控件的子控件。Gets a ControlCollection object that contains the child controls for a specified server control in the user interface hierarchy. (继承自 Part) |
| ControlStyle |
获取 Web 服务器控件的样式。Gets the style of the Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers. (继承自 WebControl) |
| ControlStyleCreated |
获取一个值,该值指示是否已为 Style 属性创建了 ControlStyle 对象。Gets a value indicating whether a Style object has been created for the ControlStyle property. 此属性主要由控件开发人员使用。This property is primarily used by control developers. (继承自 WebControl) |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client. (继承自 WebControl) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataItemContainer. (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataKeysControl. (继承自 Control) |
| DefaultButton |
获取或设置 Panel 控件中包含的默认按钮的标识符。Gets or sets the identifier for the default button that is contained in the Panel control. (继承自 Panel) |
| Description |
获取或设置一条短语,该短语在部件控件的工具提示和目录中用来概述该部件控件的作用。Gets or sets a brief phrase that summarizes what the part control does, for use in ToolTips and catalogs of part controls. (继承自 WebPart) |
| DesignMode |
获取一个值,该值指示是否正在使用设计图面上的一个控件。Gets a value indicating whether a control is being used on a design surface. (继承自 Control) |
| Direction |
获取或设置内容在控件中流动的水平方向。Gets or sets the horizontal direction that content flows within the control. (继承自 WebPart) |
| DisplayTitle |
获取一个字符串,其中包含在 WebPart 控件实例的标题栏中实际显示的完整标题文本。Gets a string that contains the full title text actually displayed in the title bar of a WebPart control instance. (继承自 WebPart) |
| Enabled |
获取或设置一个值,该值指示是否启用 Web 服务器控件。Gets or sets a value indicating whether the Web server control is enabled. (继承自 WebControl) |
| EnableTheming |
获取或设置一个值,该值指示主题是否应用于该控件。Gets or sets a value indicating whether themes apply to this control. (继承自 WebControl) |
| EnableViewState |
获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (继承自 Control) |
| ErrorMessage |
获取或设置错误信息,该错误信息显示在网页中代替未能成功添加到该页的控件。Gets or sets the error message that is displayed in a Web page in place of a control that could not be successfully added to the page. |
| Events |
获取控件的事件处理程序委托列表。Gets a list of event handler delegates for the control. 此属性是只读的。This property is read-only. (继承自 Control) |
| ExportMode |
获取或设置是否可以导出所有、某些 WebPart 控件属性或不能导出该控件的任何属性。Gets or sets whether all, some, or none of a WebPart control's properties can be exported. (继承自 WebPart) |
| Font |
获取与 Web 服务器控件关联的字体属性。Gets the font properties associated with the Web server control. (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色(通常是文本颜色)。Gets or sets the foreground color (typically the color of the text) of the Web server control. (继承自 WebControl) |
| GenericWebPartID |
从由代理 Web 部件控件所替换的一般 Web 部件控件获取 ID 属性的值。Gets the value of the ID property from the generic Web Parts control replaced by a proxy Web Parts control. (继承自 ProxyWebPart) |
| GroupingText |
获取或设置面板控件中包含的控件组的标题。Gets or sets the caption for the group of controls that is contained in the panel control. (继承自 Panel) |
| HasAttributes |
获取一个值,该值指示控件是否具有特性集。Gets a value indicating whether the control has attributes set. (继承自 WebControl) |
| HasChildViewState |
获取一个值,该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。Gets a value indicating whether the current server control's child controls have any saved view-state settings. (继承自 Control) |
| HasSharedData |
获取一个值,该值指示 WebPart 控件是否有与之关联的任何共享个性化数据。Gets a value that indicates whether a WebPart control has any shared personalization data associated with it. (继承自 WebPart) |
| HasUserData |
获取一个值,该值指示 WebPart 控件是否有与之关联的任何用户个性化数据。Gets a value that indicates whether a WebPart control has any user personalization data associated with it. (继承自 WebPart) |
| Height |
获取或设置区域的高度。Gets or sets the height of a zone. (继承自 WebPart) |
| HelpMode |
获取或设置用于显示 WebPart 控件的帮助内容的用户界面 (UI) 的类型。Gets or sets the type of user interface (UI) used to display Help content for a WebPart control. (继承自 WebPart) |
| HelpUrl |
获取或设置指向 WebPart 控件的帮助文件的 URL。Gets or sets the URL to a Help file for a WebPart control. (继承自 WebPart) |
| Hidden |
获取或设置一个值,该值指示是否在网页上显示 WebPart 控件。Gets or sets a value indicating whether a WebPart control is displayed on a Web page. (继承自 WebPart) |
| HorizontalAlign |
获取或设置面板内容的水平对齐方式。Gets or sets the horizontal alignment of the contents within the panel. (继承自 Panel) |
| ID |
获取或设置分配给 Web 部件控件的编程标识符。Gets or sets the programmatic identifier assigned to the Web Parts control. (继承自 ProxyWebPart) |
| IdSeparator |
获取用于分隔控件标识符的字符。Gets the character used to separate control identifiers. (继承自 Control) |
| ImportErrorMessage |
获取或设置在导入 WebPart 控件时发生错误的情况下将显示的错误消息。Gets or sets an error message that is used if errors occur when a WebPart control is imported. (继承自 WebPart) |
| IsChildControlStateCleared |
获取一个值,该值指示该控件中包含的控件是否具有控件状态。Gets a value indicating whether controls contained within this control have control state. (继承自 Control) |
| IsClosed |
获取一个值,该值指示 WebPart 控件当前在 Web 部件页上是否已关闭。Gets a value that indicates whether a WebPart control is currently closed on a Web Parts page. (继承自 WebPart) |
| IsEnabled |
获取一个值,该值指示是否启用控件。Gets a value indicating whether the control is enabled. (继承自 WebControl) |
| IsShared |
获取一个值,该值指示 WebPart 控件是否为共享控件,即对 Web 部件页的所有用户都可见。Gets a value that indicates whether a WebPart control is shared, meaning that it is visible to all users of a Web Parts page. (继承自 WebPart) |
| IsStandalone |
获取一个值,该值指示 WebPart 控件是否是独立控件(即该控件不包含在 WebPartZoneBase 区域中)。Gets a value that indicates whether a WebPart control is standalone, meaning that it is not contained within a WebPartZoneBase zone. (继承自 WebPart) |
| IsStatic |
获取一个值,该值指示 WebPart 控件是否为静态控件,即控件在 Web 部件页的标记中声明,而不是通过编程方式添加至页中。Gets a value that indicates whether a WebPart control is a static control, which means the control is declared in the markup of a Web Parts page and not added to the page programmatically. (继承自 WebPart) |
| IsTrackingViewState |
获取一个值,用于指示服务器控件是否会将更改保存到其视图状态中。Gets a value that indicates whether the server control is saving changes to its view state. (继承自 Control) |
| IsViewStateEnabled |
获取一个值,该值指示是否为该控件启用了视图状态。Gets a value indicating whether view state is enabled for this control. (继承自 Control) |
| LoadViewStateByID |
获取一个值,该值指示控件是否通过 ID 而不是索引参与加载其视图状态。Gets a value indicating whether the control participates in loading its view state by ID instead of index. (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 ID 属性值的服务器控件。Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value. (继承自 Control) |
| OriginalID |
获取由代理 Web 部件控件所替换的 Web 部件控件的 ID。Gets the ID of the Web Parts control replaced by the proxy Web Parts control. (继承自 ProxyWebPart) |
| OriginalPath |
获取要替换的用户控件的路径。Gets the path to the user control being replaced. (继承自 ProxyWebPart) |
| OriginalTypeName |
获取由代理 Web 部件控件所替换的 Web 部件控件的 Type。Gets the Type of the Web Parts control replaced by the proxy Web Parts control. (继承自 ProxyWebPart) |
| Page |
获取对包含服务器控件的 Page 实例的引用。Gets a reference to the Page instance that contains the server control. (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。Gets a reference to the server control's parent control in the page control hierarchy. (继承自 Control) |
| RenderingCompatibility |
获取一个值,该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (继承自 Control) |
| ScrollBars |
获取或设置 Panel 控件中滚动条的可见性和位置。Gets or sets the visibility and position of scroll bars in a Panel control. (继承自 Panel) |
| Site |
获取容器信息,该容器在呈现于设计图面上时承载当前控件。Gets information about the container that hosts the current control when rendered on a design surface. (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。Gets or sets the skin to apply to the control. (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control. (继承自 WebControl) |
| Subtitle |
获取一个字符串,该字符串与 Title 属性值连接即形成 WebPart 控件的完整标题。Gets a string that is concatenated with the Title property value to form a complete title for a WebPart control. (继承自 WebPart) |
| SupportsDisabledAttribute |
获取一个值,该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。Gets or sets the tab index of the Web server control. (继承自 WebControl) |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。Gets the HtmlTextWriterTag value that corresponds to this Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers. (继承自 WebControl) |
| TagName |
获取控件标记的名称。Gets the name of the control tag. 此属性主要由控件开发人员使用。This property is used primarily by control developers. (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。Gets or sets a reference to the template that contains this control. (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。Gets the virtual directory of the Page or UserControl that contains the current server control. (继承自 Control) |
| Title |
获取或设置部件控件的标题。Gets or sets the title of a part control. (继承自 WebPart) |
| TitleIconImageUrl |
获取或设置图像的 URL,该图像用于在控件的标题栏中表示 Web 部件控件。Gets or sets the URL to an image used to represent a Web Parts control in the control's title bar. (继承自 WebPart) |
| TitleUrl |
获取或设置有关 WebPart 控件补充信息的 URL。Gets or sets a URL to supplemental information about a WebPart control. (继承自 WebPart) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。Gets or sets the text displayed when the mouse pointer hovers over the Web server control. (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。Gets the unique, hierarchically qualified identifier for the server control. (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (继承自 Control) |
| Verbs |
获取与 WebPart 控件关联的自定义谓词的集合。Gets a collection of custom verbs associated with a WebPart control. (继承自 WebPart) |
| ViewState |
获取状态信息的字典,这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值,该值指示 StateBag 对象是否不区分大小写。Gets a value that indicates whether the StateBag object is case-insensitive. (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。Gets or sets the view-state mode of this control. (继承自 Control) |
| Visible |
获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上。Gets or sets a value that indicates whether a server control is rendered as UI on the page. (继承自 Control) |
| WebBrowsableObject |
获取对 WebPart 控件的引用,以使该控件可由自定义 EditorPart 控件进行编辑。Gets a reference to the WebPart control to enable it to be edited by custom EditorPart controls. (继承自 WebPart) |
| WebPartManager |
获取对与 WebPartManager 控件实例关联的 WebPart 控件的引用。Gets a reference to the WebPartManager control associated with a WebPart control instance. (继承自 WebPart) |
| Width |
获取或设置 Web 服务器控件的宽度。Gets or sets the width of the Web server control. (继承自 WebPart) |
| Wrap |
获取或设置一个指示面板中的内容是否换行的值。Gets or sets a value indicating whether the content wraps within the panel. (继承自 Panel) |
| Zone |
获取当前包含 WebPartZoneBase 控件的 WebPart 区域。Gets the WebPartZoneBase zone that currently contains a WebPart control. (继承自 WebPart) |
| ZoneIndex |
获取 WebPart 控件在其区域内的索引位置。Gets the index position of a WebPart control within its zone. (继承自 WebPart) |
方法
| AddAttributesToRender(HtmlTextWriter) |
将特殊错误样式特性应用于插入页中代替另一个控件的 ErrorWebPart 对象。Applies special error style attributes to an ErrorWebPart object that is inserted into a page in place of another control. |
| AddedControl(Control, Int32) |
在子控件添加到 Control 对象的 Controls 集合后调用。Called after a child control is added to the Controls collection of the Control object. (继承自 Control) |
| AddParsedSubObject(Object) |
通知服务器控件,分析了一个元素(XML 或 HTML),并将该元素添加到服务器控件的 ControlCollection 对象中。Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object. (继承自 Control) |
| ApplyStyle(Style) |
将指定样式的所有非空白元素复制到 Web 控件,覆盖控件的所有现有的样式元素。Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. 此方法主要由控件开发人员使用。This method is primarily used by control developers. (继承自 WebControl) |
| ApplyStyleSheetSkin(Page) |
将页样式表中定义的样式属性应用到控件。Applies the style properties defined in the page style sheet to the control. (继承自 Control) |
| BeginRenderTracing(TextWriter, Object) |
开始输出数据的设计时追踪。Begins design-time tracing of rendering data. (继承自 Control) |
| BuildProfileTree(String, Boolean) |
收集有关服务器控件的信息并将该信息发送到 Trace 属性,在启用页的跟踪功能时将显示该属性。Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (继承自 Control) |
| ClearCachedClientID() |
将缓存的 ClientID 值设置为 |
| ClearChildControlState() |
删除服务器控件的子控件的控件状态信息。Deletes the control-state information for the server control's child controls. (继承自 Control) |
| ClearChildState() |
删除服务器控件的所有子控件的视图状态和控件状态信息。Deletes the view-state and control-state information for all the server control's child controls. (继承自 Control) |
| ClearChildViewState() |
删除服务器控件的所有子控件的视图状态信息。Deletes the view-state information for all the server control's child controls. (继承自 Control) |
| ClearEffectiveClientIDMode() |
将当前控件实例和任何子控件的 ClientIDMode 属性设置为 Inherit。Sets the ClientIDMode property of the current control instance and of any child controls to Inherit. (继承自 Control) |
| CopyBaseAttributes(WebControl) |
将 Style 对象未封装的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. 此方法主要由控件开发人员使用。This method is used primarily by control developers. (继承自 WebControl) |
| CreateChildControls() |
由 ASP.NET 页框架调用,以通知服务器控件在准备回发或呈现时使用基于撰写的实现来创建其所包含任何子控件。Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (继承自 Control) |
| CreateControlCollection() |
创建一个新 ControlCollection 对象来保存服务器控件的子控件(包括文本控件和服务器控件)。Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control. (继承自 Control) |
| CreateControlStyle() |
创建由 Panel 控件在内部用来实现所有与样式有关的属性的样式对象。Creates a style object that is used internally by the Panel control to implement all style related properties. (继承自 Panel) |
| CreateEditorParts() |
返回自定义 EditorPart 控件的集合,这些控件可用于在 WebPart 控件处于编辑模式时对其进行编辑。Returns a collection of custom EditorPart controls that can be used to edit a WebPart control when it is in edit mode. (继承自 WebPart) |
| DataBind() |
将数据源绑定到调用的服务器控件及其所有子控件。Binds a data source to the invoked server control and all its child controls. (继承自 Part) |
| DataBind(Boolean) |
将数据源绑定到调用的服务器控件及其所有子控件,同时可以选择引发 DataBinding 事件。Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event. (继承自 Control) |
| DataBindChildren() |
将数据源绑定到服务器控件的子控件。Binds a data source to the server control's child controls. (继承自 Control) |
| Dispose() |
使服务器控件得以在从内存中释放之前执行最后的清理操作。Enables a server control to perform final clean up before it is released from memory. (继承自 Control) |
| EndLoadPersonalization() |
在呈现之前设置 ErrorWebPart 控件的几个重要属性,以防止用户能够对该控件进行个性化设置。Sets several important properties on the ErrorWebPart control prior to rendering, to prevent users from being able to personalize the control. |
| EndRenderTracing(TextWriter, Object) |
结束输出数据的设计时追踪。Ends design-time tracing of rendering data. (继承自 Control) |
| EnsureChildControls() |
确定服务器控件是否包含子控件。Determines whether the server control contains child controls. 如果不包含,则创建子控件。If it does not, it creates child controls. (继承自 Control) |
| EnsureID() |
为尚未分配标识符的控件创建标识符。Creates an identifier for controls that do not have an identifier assigned. (继承自 Control) |
| Equals(Object) |
确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object. (继承自 Object) |
| FindControl(String) |
在当前的命名容器中搜索带指定 |
| FindControl(String, Int32) |
使用指定的 |
| Focus() |
为控件设置输入焦点。Sets input focus to a control. (继承自 Control) |
| GetDesignModeState() |
获取控件的设计时数据。Gets design-time data for a control. (继承自 Control) |
| GetHashCode() |
作为默认哈希函数。Serves as the default hash function. (继承自 Object) |
| GetRouteUrl(Object) |
获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters. (继承自 Control) |
| GetRouteUrl(RouteValueDictionary) |
获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters. (继承自 Control) |
| GetRouteUrl(String, Object) |
获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name. (继承自 Control) |
| GetRouteUrl(String, RouteValueDictionary) |
获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name. (继承自 Control) |
| GetType() |
获取当前实例的 Type。Gets the Type of the current instance. (继承自 Object) |
| GetUniqueIDRelativeTo(Control) |
返回指定控件的 UniqueID 属性的前缀部分。Returns the prefixed portion of the UniqueID property of the specified control. (继承自 Control) |
| HasControls() |
确定服务器控件是否包含任何子控件。Determines if the server control contains any child controls. (继承自 Control) |
| HasEvents() |
返回一个值,该值指示是否为控件或任何子控件注册事件。Returns a value indicating whether events are registered for the control or any child controls. (继承自 Control) |
| IsLiteralContent() |
确定服务器控件是否只包含文字内容。Determines if the server control holds only literal content. (继承自 Control) |
| LoadControlState(Object) |
重写 LoadControlState(Object) 以避免加载 ProxyWebPart 对象以前保存的状态。Overrides LoadControlState(Object) to prevent loading previously saved state for a ProxyWebPart object. (继承自 ProxyWebPart) |
| LoadViewState(Object) |
重写 LoadViewState(Object) 以避免加载 ProxyWebPart 对象的以前保存的视图状态。Overrides LoadViewState(Object) to prevent loading previously saved view state for a ProxyWebPart object. (继承自 ProxyWebPart) |
| MapPathSecure(String) |
检索虚拟路径(绝对的或相对的)映射到的物理路径。Retrieves the physical path that a virtual path, either absolute or relative, maps to. (继承自 Control) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。Creates a shallow copy of the current Object. (继承自 Object) |
| MergeStyle(Style) |
将指定样式的所有非空白元素复制到 Web 控件,但不覆盖该控件现有的任何样式元素。Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. 此方法主要由控件开发人员使用。This method is used primarily by control developers. (继承自 WebControl) |
| OnBubbleEvent(Object, EventArgs) |
确定服务器控件的事件是否沿页的 UI 服务器控件层次结构向上传递。Determines whether the event for the server control is passed up the page's UI server control hierarchy. (继承自 Control) |
| OnClosing(EventArgs) |
启用派生类,以在 Web 部件页中关闭 WebPart 控件时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is closed on a Web Parts page. (继承自 WebPart) |
| OnConnectModeChanged(EventArgs) |
启用派生类,以在 WebPart 控件开始或结束与其他控件的连接过程时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is beginning or ending the process of connecting to other controls. (继承自 WebPart) |
| OnDataBinding(EventArgs) |
引发 DataBinding 事件。Raises the DataBinding event. (继承自 Control) |
| OnDeleting(EventArgs) |
启用派生类,以在从 Web 部件页中永久移除 WebPart 控件时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is permanently removed from a Web Parts page. (继承自 WebPart) |
| OnEditModeChanged(EventArgs) |
启用派生类,以在 WebPart 控件进入或离开编辑模式时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is entering or leaving edit mode. (继承自 WebPart) |
| OnInit(EventArgs) |
引发 Init 事件。Raises the Init event. (继承自 Control) |
| OnLoad(EventArgs) |
引发 Load 事件。Raises the Load event. (继承自 Control) |
| OnPreRender(EventArgs) |
引发 PreRender 事件。Raises the PreRender event. (继承自 Control) |
| OnUnload(EventArgs) |
引发 Unload 事件。Raises the Unload event. (继承自 Control) |
| OpenFile(String) |
获取用于读取文件的 Stream。Gets a Stream used to read a file. (继承自 Control) |
| RaiseBubbleEvent(Object, EventArgs) |
将所有事件源及其信息分配给控件的父级。Assigns any sources of the event and its information to the control's parent. (继承自 Control) |
| RemovedControl(Control) |
从 Control 对象的 Controls 集合移除子控件后调用。Called after a child control is removed from the Controls collection of the Control object. (继承自 Control) |
| Render(HtmlTextWriter) |
将控件呈现给指定的 HTML 编写器。Renders the control to the specified HTML writer. (继承自 WebControl) |
| RenderBeginTag(HtmlTextWriter) |
将 Panel 控件的 HTML 开始标记呈现到指定的编写器中。Renders the HTML opening tag of the Panel control to the specified writer. (继承自 Panel) |
| RenderChildren(HtmlTextWriter) |
将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象,该对象可写入要在客户端上呈现的内容。Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (继承自 Control) |
| RenderContents(HtmlTextWriter) |
对 ErrorMessage 属性的字符串值进行编码。Encodes the string value of the ErrorMessage property. |
| RenderControl(HtmlTextWriter) |
将服务器控件内容输出到所提供的 HtmlTextWriter 对象,如果启用了跟踪,则还将存储有关该控件的跟踪信息。Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (继承自 Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object. (继承自 Control) |
| RenderEndTag(HtmlTextWriter) |
将 Panel 控件的 HTML 结束标记呈现到指定的编写器中。Renders the HTML closing tag of the Panel control into the specified writer. (继承自 Panel) |
| ResolveAdapter() |
获取负责呈现指定控件的控件适配器。Gets the control adapter responsible for rendering the specified control. (继承自 Control) |
| ResolveClientUrl(String) |
获取浏览器可以使用的 URL。Gets a URL that can be used by the browser. (继承自 Control) |
| ResolveUrl(String) |
将 URL 转换为在请求客户端可用的 URL。Converts a URL into one that is usable on the requesting client. (继承自 Control) |
| SaveControlState() |
保存将页面回发到服务器之后发生的所有服务器控件状态更改。Saves any server control state changes that have occurred since the time the page was posted back to the server. (继承自 ProxyWebPart) |
| SaveViewState() |
保存调用 TrackViewState() 方法后修改的任何状态。Saves any state that was modified after the TrackViewState() method was invoked. (继承自 ProxyWebPart) |
| SetDesignModeState(IDictionary) |
为控件设置设计时数据。Sets design-time data for a control. (继承自 Control) |
| SetPersonalizationDirty() |
设置一个标志,以指示当前 WebPart 控件实例的个性化数据已更改。Sets a flag indicating that personalization data has changed for the current WebPart control instance. (继承自 WebPart) |
| SetRenderMethodDelegate(RenderMethod) |
分配事件处理程序委托,以将服务器控件及其内容呈现到父控件中。Assigns an event handler delegate to render the server control and its content into its parent control. (继承自 Control) |
| SetTraceData(Object, Object) |
使用跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (继承自 Control) |
| SetTraceData(Object, Object, Object) |
使用跟踪对象、跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (继承自 Control) |
| ToString() |
返回表示当前对象的字符串。Returns a string that represents the current object. (继承自 Object) |
| TrackViewState() |
使控件跟踪其视图状态的更改,以便将这些更改存储在对象的 ViewState 属性中。Causes the control to track changes to its view state so they can be stored in the object's ViewState property. (继承自 WebPart) |
事件
| DataBinding |
当服务器控件绑定到数据源时发生。Occurs when the server control binds to a data source. (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生存期的最后阶段。Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (继承自 Control) |
| Init |
当服务器控件初始化时发生;初始化是控件生存期的第一步。Occurs when the server control is initialized, which is the first step in its lifecycle. (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。Occurs when the server control is loaded into the Page object. (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。Occurs after the Control object is loaded but prior to rendering. (继承自 Control) |
| Unload |
当服务器控件从内存中卸载时发生。Occurs when the server control is unloaded from memory. (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。Returns the data source that is associated with the data control for the specified control. |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。Returns the field template for the specified column in the specified control's naming container. |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。Returns the metatable object for the containing data control. |
| GetDefaultValues(INamingContainer) |
为指定数据控件获取默认值的集合。Gets the collection of the default values for the specified data control. |
| GetMetaTable(INamingContainer) |
为指定数据控件获取表元数据。Gets the table metadata for the specified data control. |
| SetMetaTable(INamingContainer, MetaTable) |
为指定数据控件设置表元数据。Sets the table metadata for the specified data control. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control. |
| TryGetMetaTable(INamingContainer, MetaTable) |
确定表元数据是否可用。Determines whether table metadata is available. |
| EnableDynamicData(INamingContainer, Type) |
为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control. |
| EnableDynamicData(INamingContainer, Type, Object) |
为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control. |