CatalogPart 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
用作驻留在 CatalogZoneBase 区域的控件的基类，这些控件提供用户可添加到网页的可用 Web 服务器控件（尤其是 WebPart 控件）的目录。
public ref class CatalogPart abstract : System::Web::UI::WebControls::WebParts::Part[System.ComponentModel.Bindable(false)]
public abstract class CatalogPart : System.Web.UI.WebControls.WebParts.Part[<System.ComponentModel.Bindable(false)>]
type CatalogPart = class
inherit PartPublic MustInherit Class CatalogPart
Inherits Part- 继承
- 派生
- 属性
示例
下面的代码示例演示如何使用 CatalogPart 类。 由于 类是抽象的，因此不会在代码中直接使用它。 但是，该示例演示如何使用 Web 部件控件集提供的三个派生 CatalogPart 控件，以演示常见使用方案。
代码示例包含四个部分：
一个用户控件，可用于更改网页上的显示模式。
一个网页，其中包含随 Web 部件控件集一起提供的三 CatalogPart 个控件，这些控件都在网页上的 中 CatalogZone 声明。 该页还包含一个 WebPartZone 控件，并在区域中声明了一个 AdRotator 控件。
一个 XML 文件，其中包含网页上控件 AdRotator 中显示的引号。
有关如何运行示例的说明。
此代码示例的第一部分是用户控件，使用户能够更改网页上的显示模式。 应将此代码保存在名为 DisplayModeMenuCS.ascx 或 DisplayModeMenuVB.ascx (的文件中，具体取决于) 使用的语言。 有关显示模式的详细信息和此控件中的源代码说明，请参阅 演练：更改 Web 部件页上的显示模式。
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName, modeName);
DisplayModeDropdown.Items.Add(item);
}
}
// If shared scope is allowed for this user, display the scope-switching
// UI and select the appropriate radio button for the current user scope.
if (_manager.Personalization.CanEnterSharedScope)
{
Panel2.Visible = true;
if (_manager.Personalization.Scope == PersonalizationScope.User)
RadioButton1.Checked = true;
else
RadioButton2.Checked = true;
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
// Set the selected item equal to the current display mode.
void Page_PreRender(object sender, EventArgs e)
{
ListItemCollection items = DisplayModeDropdown.Items;
int selectedIndex =
items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
DisplayModeDropdown.SelectedIndex = selectedIndex;
}
// Reset all of a user's personalization data for the page.
protected void LinkButton1_Click(object sender, EventArgs e)
{
_manager.Personalization.ResetPersonalizationState();
}
// If not in User personalization scope, toggle into it.
protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.Scope == PersonalizationScope.Shared)
_manager.Personalization.ToggleScope();
}
// If not in Shared scope, and if user is allowed, toggle the scope.
protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope &&
_manager.Personalization.Scope == PersonalizationScope.User)
_manager.Personalization.ToggleScope();
}
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _
_manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
代码示例的第二部分是网页。 页面包含一个 CatalogZone 控件，在子 <zonetemplate> 元素中，声明随 Web 部件控件集提供的三 CatalogPart 个控件中的每一个。 某些属性是在控件上设置的 DeclarativeCatalogPart ，而且在 <页面的脚本> 部分中，该控件上的属性是以编程方式访问的。 控件包含一个用户可以添加到页面的子控件：标准 Calendar 控件。
CatalogZone和 CatalogPart 控件仅在用户将页面切换到目录显示模式时可见。
该页还包含一个 WebPartZone 控件，其子 <zonetemplate> 元素中是一个 AdRotator 显示 XML 文件中交替消息的控件。 如果用户在显示页面时通过单击控件的 close 谓词来关闭控件，则控件将添加到页面目录，并且用户可以通过将页面切换到目录显示模式、访问 PageCatalogPart 控件以及添加回关闭的控件来重新打开控件。
<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3>
protected void Button1_Click(object sender, EventArgs e)
{
Label1.Text = "<h3>DeclarativeCatalogPart Property Values</h3>" +
"Display Title: " + DeclarativeCatalogPart1.DisplayTitle +
"<br />" +
"Description: " + DeclarativeCatalogPart1.Description +
"<br />" +
"Chrome type: " + DeclarativeCatalogPart1.ChromeType.ToString();
}
protected void WebPartManager1_DisplayModeChanged(object sender,
WebPartDisplayModeEventArgs e)
{
Label1.Text = String.Empty;
if (WebPartManager1.DisplayMode == WebPartManager.CatalogDisplayMode)
Button1.Visible = true;
else
Button1.Visible = false;
}
// </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CatalogPart Samples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server"
OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:AdRotator ID="AdRotator1" runat="server"
AdvertisementFile="~/quotes.xml"
Title="Favorite Quotes" />
</ZoneTemplate>
</asp:WebPartZone>
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="DeclarativeCatalogPart1"
runat="server"
Title="Controls to Add"
ChromeType="TitleOnly"
Description="Provides a list of controls that users can
add to the page.">
<WebPartsTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
<asp:importcatalogpart id="ImportCatalogPart1" runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Display DeclarativeCatalogPart Properties"
OnClick="Button1_Click"
Visible="false"/>
<br />
<asp:Label ID="Label1" runat="server" Text="" />
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet3>
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
Label1.Text = "<h3>DeclarativeCatalogPart Property Values</h3>" & _
"Display Title: " & DeclarativeCatalogPart1.DisplayTitle & _
"<br />" & _
"Description: " & DeclarativeCatalogPart1.Description & _
"<br />" & _
"Chrome type: " & DeclarativeCatalogPart1.ChromeType.ToString()
End Sub
Protected Sub WebPartManager1_DisplayModeChanged(ByVal sender _
As Object, ByVal e As WebPartDisplayModeEventArgs)
Label1.Text = String.Empty
If WebPartManager1.DisplayMode _
Is WebPartManager.CatalogDisplayMode Then
Button1.Visible = True
Else
Button1.Visible = False
End If
End Sub
' </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CatalogPart Samples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server"
OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:AdRotator ID="AdRotator1" runat="server"
AdvertisementFile="~/quotes.xml"
Title="Favorite Quotes" />
</ZoneTemplate>
</asp:WebPartZone>
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="DeclarativeCatalogPart1"
runat="server"
Title="Controls to Add"
ChromeType="TitleOnly"
Description="Provides a list of controls that users can
add to the page.">
<WebPartsTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
<asp:importcatalogpart id="ImportCatalogPart1" runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Display DeclarativeCatalogPart Properties"
OnClick="Button1_Click"
Visible="false"/>
<br />
<asp:Label ID="Label1" runat="server" Text="" />
</form>
</body>
</html>
代码示例的第三部分是 XML 文件。 此文件是页面上声明的 AdRotator 控件的源文件。 文件包含常用引号，控件会定期旋转并显示这些引号。 将以下内容复制到文本编辑器中，并将文件另存为 Quotes.xml。
<?xml version="1.0" encoding="utf-8" ?>
<Advertisements>
<Ad>
<AlternateText>
A stitch in time saves nine.
</AlternateText>
</Ad>
<Ad>
<AlternateText>
A penny saved is a penny earned.
</AlternateText>
</Ad>
</Advertisements>
若要运行代码示例，请在浏览器中加载网页。 使用 “显示模式 ”下拉控件选择“ 目录 ”，并将页面切换到目录显示模式。 请注意，在包含Calendar控件的控件上DeclarativeCatalogPart设置的各种属性值的效果。 可以选中控件旁边的 Calendar 复选框，然后单击“ 添加 ”将其添加到页面。 如果单击“ 显示声明性CatalogPart 属性” 按钮，则会显示该控件的属性值。 可以单击“ 关闭 ”将页面返回到正常浏览模式，并在页面上查看添加的控件。 现在转到由标题栏中) 向下箭头表示的控件 (谓词菜单 AdRotator ，然后单击“ 关闭”。 控件将关闭并添加到页面目录。 再次将页面切换到目录显示模式，然后单击“页面目录”超链接以显示控件 PageCatalogPart 。 请注意，控件 AdRotator 由其标题 “收藏夹引用”引用。 选择 “收藏夹报价” 控件，然后单击“ 添加 ”按钮将控件添加回页面。 单击“ 关闭 ”按钮将页面返回到浏览模式。
注意
此 ImportCatalogPart 页上也声明了控件，但更涉及一个演示如何导入控件的示例，因此，此代码示例中未演示控件的完全使用。 若要查看完整的工作示例，请参阅 类或 类的ImportCatalogPartCatalogZone类概述文档。
注解
类 CatalogPart 是驻留在区域中的特殊控件的 CatalogZoneBase 基类。 这些派生 CatalogPart 控件提供最终用户可添加到网页的 Web 服务器控件目录。 如果想要通过添加或删除服务器控件为最终用户提供更改网页功能的灵活性，请使用 CatalogPart Web 应用程序中的控件。
目录只是一个或多个可用 Web 服务器控件的列表， (包括 WebPart 控件、ASP.NET 服务器控件以及用户可以添加到网页的自定义或用户控件) 。 目录具有许多共同特征，包括最终用户的说明文本;描述每个服务器控件的文本;用于选择服务器控件并将其添加到页面的帮助程序控件;通用页眉、页脚和边框;和许多样式属性。
Web 部件控件集提供了三种类型的 CatalogPart 控件，如下表所述。 每种类型的 CatalogPart 控件都包含从不同源添加到页面的服务器控件。
重要
从 类继承的 CatalogPart 控件只能驻留在派生自 类的区域 CatalogZoneBase 中。
| 控制 | 说明 |
|---|---|
| PageCatalogPart | 包含已在页面上关闭且可重新打开的控件， (用户) 添加回页面。 此类型目录中的控件是已从其他源添加到页面的控件，然后由用户关闭。 |
| DeclarativeCatalogPart | 包含控件中 DeclarativeCatalogPart 声明的服务器控件，该控件本身包含在 CatalogZoneBase 网页标记中的区域中。 |
| ImportCatalogPart | 提供用户界面 (UI) 供用户上传控件的定义文件 (架构定义的 XML 文件，其中包含) 目录的状态信息，以便可以将控件添加到网页。 控件本身不会出现在这种类型的目录中;目录只是一种机制，用于访问外部控件的定义文件，以便可以将其添加到页面。 |
类 CatalogPart 继承自基 Part 类，使其具有 Web 部件控件集中其他部件控件的常见行为。 此外，它还添加了一些对目录功能有用的成员。 属性 DisplayTitle 获取当前显示为控件标题的实际字符串。 此属性的值可以与 属性的值 Title 相同，如果未向该属性分配任何值，则为 .NET Framework 提供的默认值。 WebPartManager和 Zone 属性都为控制控件生命周期的两个CatalogPart基本对象提供了方便的访问：WebPartManager控件和CatalogZoneBase包含控件CatalogPart的区域。
类 CatalogPart 还包含多个方法。 方法 GetAvailableWebPartDescriptions 声明为必须由继承器实现的抽象方法。 其预期用途是返回目录中控件的说明集合。 相关方法 GetWebPart也声明为抽象方法，必须由继承器实现。 此方法旨在基于作为参数传递给方法的说明返回控件的实例 WebPart 。
实施者说明
CatalogPart因为 类是抽象的，所以不能直接在网页上使用它。 Web 部件控件集提供 CatalogPart 三个控件 (列在本主题的“备注”部分中的表中，这些控件) 派生自基类，可在 Web 部件页上使用。 这些控件应提供创建 Web 服务器控件目录所需的大部分功能。 但是，你可能有需要开发自定义 CatalogPart 控件的特殊需求。 例如，可以创建一种特殊类型的 CatalogPart 控件，使服务器控件通过 Web 服务或直接从数据库提供。 为此，必须从 CatalogPart 类继承。 还必须重写抽象 GetAvailableWebPartDescriptions() 和 GetWebPart(WebPartDescription) 方法，以提供返回 WebPart 或其他服务器控件及其说明的实现。 还需要通过方法从数据库或 Web 服务加载各种服务器控件。
构造函数
| CatalogPart() |
初始化该类供继承的类实例使用。 此构造函数只能由继承的类调用。 |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BackImageUrl |
获取或设置面板控件背景图像的 URL。 (继承自 Panel) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ChromeState |
获取或设置部件控件是处于最小化状态还是正常状态。 (继承自 Part) |
| ChromeType |
获取或设置构成 Web 部件控件的框架的边框类型。 (继承自 Part) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| 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 |
获取或设置一条短语，该短语在部件控件的工具提示和目录中用来概述该部件控件的作用。 (继承自 Part) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Direction |
获取或设置在 Panel 控件中显示包含文本的控件的方向。 (继承自 Panel) |
| DisplayTitle |
获取一个字符串，其中包含 CatalogPart 控件的实际当前标题。 |
| Enabled |
获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl) |
| GroupingText |
获取或设置面板控件中包含的控件组的标题。 (继承自 Panel) |
| HasAttributes |
获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| HorizontalAlign |
获取或设置面板内容的水平对齐方式。 (继承自 Panel) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsEnabled |
获取一个值，该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| ScrollBars |
获取或设置 Panel 控件中滚动条的可见性和位置。 (继承自 Panel) |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| Title |
获取或设置部件控件的标题。 (继承自 Part) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| WebPartManager |
获取对 WebPartManager 类的当前实例的引用。 |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
| Wrap |
获取或设置一个指示面板中的内容是否换行的值。 (继承自 Panel) |
| Zone |
获取对包含 CatalogZoneBase 控件的 CatalogPart 区域的引用。 |
方法
事件
| 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) |
为指定数据控件启用动态数据行为。 |
