WebZone 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
作为 Web 部件应用程序中充当服务器控件的容器的所有控件（包括 Web 部件 Part 控件、服务器控件和用户控件）的基类。
public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl[<System.ComponentModel.Bindable(false)>]
type WebZone = class
inherit CompositeControlPublic MustInherit Class WebZone
Inherits CompositeControl- 继承
- 派生
- 属性
示例
下面的代码示例演示如何使用 WebZone 类。
代码示例的第一部分显示了派生自 WebPart 类的两个自定义控件。 若要运行代码示例，必须编译此源代码。 可以显式编译它，并将生成的程序集放入网站的 Bin 文件夹或全局程序集缓存中。 或者，可以将源代码放在站点的“App_Code”文件夹中，并在运行时对其进行动态编译。 有关演示这两种编译方法的演练，请参阅 演练：开发和使用自定义 Web 服务器控件。
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class CalendarWebPart : WebPart
{
Calendar _calendar;
public CalendarWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_calendar = new Calendar();
_calendar.Caption = "My Calendar";
this.Controls.Add(_calendar);
ChildControlsCreated = true;
}
}
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class LinksWebPart : WebPart
{
Literal _literal;
const string _literalText = @"
<table>
<tr>
<td><a href='http://msdn.microsoft.com'>MSDN</a></td>
</tr>
<tr>
<td><a href='http://msn.microsoft.com'>MSN</a></td>
</tr>
<tr>
<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
</tr>
</table>";
public LinksWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_literal = new Literal();
_literal.Text = _literalText;
this.Controls.Add(_literal);
ChildControlsCreated = true;
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class CalendarWebPart
Inherits WebPart
Private _calendar As Calendar
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_calendar = New Calendar()
_calendar.Caption = "My Calendar"
Me.Controls.Add(_calendar)
ChildControlsCreated = True
End Sub
End Class
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class LinksWebPart
Inherits WebPart
Private _literal As Literal
Private Const _literalText As String = _
"<table>" & _
"<tr>" & _
"<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
"</tr>" & _
"</table>"
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_literal = New Literal()
_literal.Text = _literalText
Me.Controls.Add(_literal)
ChildControlsCreated = True
End Sub
End Class
End Namespace
代码示例的第二部分显示了承载控件的 WebPart 网页。 请注意，声明性标记包含两 WebPartZone 个控件：一个 CatalogZone 控件和一个 EditorZone 控件。
<%@ page language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
可以在浏览器中加载页面，并在各种页面显示模式之间切换，以查看不同区域的行为方式。 有关显示模式和允许用户在其中切换的详细信息，请参阅 演练：更改 Web 部件页上的显示模式。
注解
Web 部件区域是一个定义的区域，其中包含网页上的服务器控件，并为包含的控件提供一致的用户界面 (UI) 、布局和呈现。 区域在浏览器中呈现为 HTML 表。
类 WebZone 是所有 Web 部件区域的基类。 区域控件是设计为包含其他控件的复合控件，因此类 WebZone 继承自 CompositeControl 类。 与WebPartManagerPart (控件或可放置在区域) 中的其他用户或服务器控件一起，从WebZone基类派生的区域控件构成了 Web 部件应用程序的基本构建基块。
Web 部件区域的关键作用是为它们包含的控件启用完整的 Web 部件功能。 每个 Web 部件页至少包含一个区域，一个区域可以包含零个或多个部件控件。 Web 部件功能需要区域。 如果没有区域，即使是派生自 类的 WebPart 控件也只能具有很少的 Web 部件功能。 相反，由于 Web 部件控件集的设计，您可以将普通 ASP.NET 控件、服务器控件或用户控件放入 WebPartZoneBase 派生自 WebZone) 的区域 (，并且由于位于区域中，这些普通服务器控件能够在运行时充当 WebPart 控件。 有关详细信息，请参阅 类的文档 GenericWebPart 。
Web 部件控件集中有两大类区域，它们都继承自基 WebZone 类。
WebPartZoneBase 区。 这些控件包含 WebPart (和其他服务器和用户) 控件，并构成用户与大多数时间交互的 Web 部件页的主 UI。
ToolZone 区。 这些区域提供 Web 部件页的特殊视图，使用户能够修改 (个性化) Web 部件页上区域中包含的 WebPartZoneBase 控件的内容、布局、外观、行为和属性。 例如， CatalogZoneBase 区域是一个 ToolZone ，它提供页面的目录视图，使用户能够添加和删除服务器控件。 EditorZoneBase区域是另一种ToolZone类型，它提供页面的编辑视图，使用户能够修改和编辑页面布局以及控件的属性、外观和行为。
Web 部件控件集中的每个区域都设计为包含派生自 Part 类的相应类型的控件，部件控件充当区域的main内容和主要 UI。 下表显示了 Web 部件控件集中的区域类型以及它们包含的相应部件控件类型。
| 部件控件类型 | 区域类型 |
|---|---|
| WebPart (以及服务器和用户控件，在运行时用 GenericWebPart 包装) | WebPartZone (基类) WebPartZoneBase |
| EditorPart (Web 部件控件集提供多个派生控件，并且可以开发自定义 EditorPart 控件) | EditorZone (基类) EditorZoneBase |
| CatalogPart (Web 部件控件集提供多个派生控件，并且可以开发自定义 CatalogPart 控件) | CatalogZone (基类) CatalogZoneBase |
| WebPartConnection (连接控件是唯一的，因为它们不是继承自基类) | ConnectionsZone (直接从 ToolZone ) 继承 |
Web 部件控件中的所有区域都具有从基 WebZone 类继承的基本通用用户界面元素。 并非所有这些元素在每个区域中都可见，但每个区域类型都能够具有这些与区域相关的常见 UI 元素，如下表所述。
| 区域部分 | 说明 |
|---|---|
| 标头 | 区域的顶部部分。 它包括标题文本，其中可以包含区域的标题;样式属性 (，例如区分标题的边框或背景色) ;和区域级谓词 (由按钮、超链接或图像表示) ，用户可以单击这些按钮、超链接或图像来执行应用于整个区域的 UI 操作，例如关闭区域。 多个 WebZone 属性（如 HasHeader、 HeaderStyle和 HeaderText）与区域的标头区域相关。 如果区域中有区域级谓词，则 VerbButtonType 和 VerbStyle 属性将应用于它们。 请注意，这两个谓词属性仅适用于区域级谓词，不适用于区域中包含的各个部件控件中的谓词。 标头并不存在于每种类型的区域中;它们通常出现在 ToolZone 需要具有文本和动词的公用页眉区域（如闭合谓词）的区域。 |
| 正文 | 区域的main内容部分。 派生自 WebZone 的每个区域都有一个正文部分。 对于 Web 部件控件集中所有类型的区域，区域的正文包含指定类型的 Part 控件 (或其他服务器控件) 对应于区域类型，如上表所示。 类的各种 WebZone 成员会影响正文部分的内容，例如 BackImageUrl、 PartChromeStyle、 PartChromeType和 PartStyle 属性。 如果正文部分为空， EmptyZoneText 则可以在某些情况下显示消息。 |
| Chrome | 为区域中每个部件控件呈现的常见 UI 元素。 这不同于对适用于区域本身的样式属性的讨论;chrome 专用于包含的部件控件。 Chrome 包括谓词、边框和其他样式属性，例如区域部件控件的背景色或标题文本的字体样式。 区域通过使用适合其包含的部件控件类型的单个部件对象来确定部件的详细信息 (例如，CatalogPartChrome包含控件) 的 对象CatalogZoneCatalogPart。 此单个部件版式对象处理区域中的所有部件控件的部件详细信息和呈现。 这使开发人员能够创建区域，在其中他们可以为所有部件控件指定一致、通用的外观。 与区域部件控件的部件版式相关的一些属性包括 PartChromeStyle、 PartChromeType、 PartStyle和 PartTitleStyle 属性。 请注意，大多数与 Chrome 相关的属性（包括用于引用特定类型区域部件版式对象的特定属性）未在基 WebZone 类中实现。 相反，区域的大多数特定于部件控件的功能都在特定区域类型上实现，以满足其部件控件的独特需求。 请参阅本主题上表中列出的每种区域类型的主题。 |
| 部件控件 | 驻留在区域的正文部分中的控件。 从 WebZone 类继承的每个区域在其正文节中包含一个或多个相应类型的部件控件，如本主题的上表所示。 这些部件控件构成了 Web 部件应用程序的main UI。 派生自 WebZone 的大多数区域类型都具有集合属性，该属性允许它们引用其包含的所有部件控件，例如 WebParts 类上的 WebPartZoneBase 属性和 EditorParts 类上的 EditorZoneBase 属性。 |
| 脚注 | 区域的底部部分。 与标头部分一样，它并不存在于每种类型的区域中，但通常出现在 ToolZone 区域中。 页脚部分的典型内容是动作，如 ok 谓词或应用谓词，它们显示在区域的页脚 EditorZoneBase 中。 与页脚部分相关的一些属性包括 HasFooter、 FooterStyle、 VerbButtonType和 VerbStyle 属性。 |
WebZone上表中介绍了该类的大多数属性，该表描述了区域的常见 UI 元素。 类 WebZone 还具有几种与其呈现内容的角色相关的方法。 RenderBodyRenderContents、、 RenderFooter和 RenderHeader 方法都可以重写，以提供对区域每个特定部分的呈现的编程控制。 例如，如果要自定义应用程序中目录区域的所有页脚部分的呈现，则可以从 CatalogZoneBase 类继承，重写 RenderFooter 继承自 WebZone的方法，并更改页脚部分的呈现。
实施者说明
你很少需要直接从 WebZone 类继承来开发自定义 Web 部件区域。 Web 部件控件集包含上面“备注”部分中列出的专用区域，通常可以从其中一个区域派生，以向区域添加自定义行为。 如果决定直接从 WebZone 类继承，则必须重写许多属性和方法， (请参阅) 类成员 WebZone 的文档。 您还必须创建自定义 WebPartManager 控件（可选） WebPartDisplayMode 创建自定义控件以创建用于查看区域的唯一显示模式，以及使区域在 Web 部件控件集中正常工作的其他自定义项。
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BackImageUrl |
获取或设置指向区域的背景图像的 URL。 |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取表示 ControlCollection 中的子控件的 CompositeControl 对象。 (继承自 CompositeControl) |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值，该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| EmptyZoneText |
获取或设置当区域不包含任何控件时显示的消息。 |
| EmptyZoneTextStyle |
获取空区域中的占位符文本的样式特性。 |
| Enabled |
获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| ErrorStyle |
获取用于呈现在无法加载或创建 WebPart 控件时显示的错误消息的样式特性。 |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| FooterStyle |
获取区域的页脚区域内容的样式特性。 |
| ForeColor |
获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl) |
| HasAttributes |
获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| HasFooter |
获取一个值，该值指示区域中是否具有页脚区域。 |
| HasHeader |
获取一个值，该值指示区域是否具有页眉区域。 |
| HeaderStyle |
获取区域的页眉区域内容的样式特性。 |
| HeaderText |
获取或设置区域的页眉区的文本。 |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsEnabled |
获取一个值，该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Padding |
获取或设置区域中包含 WebPart 控件的表的单元格填充特性。 |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| PartChromePadding |
获取或设置 WebPart 控件的内容和此控件的边框之间的距离。 |
| PartChromeStyle |
获取适用于区域所包含的 Web 部件控件的边框的样式属性。 |
| PartChromeType |
获取或设置构成区域所包含的 Web 部件控件的框架的边框类型。 |
| PartStyle |
获取适用于区域所包含的每个 Web 部件控件的边框和内容的样式属性。 |
| PartTitleStyle |
获取区域所包含的每个 Web 部件控件的标题栏内容的样式特性。 |
| RenderClientScript |
获取一个值，该值指示是否在 Web 部件页上呈现客户端脚本。 |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| VerbButtonType |
获取或设置区域中用于表示谓词的按钮的种类。 |
| VerbStyle |
获取与区域中的 Web 部件控件关联的用户界面 (UI) 谓词的样式特性。 |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| WebPartManager |
获取对与 Web 部件页上的 WebPartManager 控件实例关联的 WebZone 控件的引用。 |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
事件
| 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) |
为指定数据控件启用动态数据行为。 |
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈