AppearanceEditorPart Web 服务器控件提供了一个编辑器控件,最终用户可以使用该控件在相关联的 WebPart 控件上编辑数个用户界面 (UI) 属性。
AppearanceEditorPart 控件使最终用户能够编辑 WebPart 控件的几个用户界面属性。下表列出了用户可自定义的功能,以及可使用 AppearanceEditorPart 控件编辑的对应的 WebPart 控件属性值。
用户可自定义的功能
WebPart 控件属性
为标题设置文本。
Title
选择标题和边框选项类型。
ChromeType
选择内容在页上的流动方向。
Direction
设置高度和单位。
Height
设置宽度和单位。
Width
隐藏或显示控件。
Hidden
若要能够编辑 WebPart 控件的其他属性和行为,可使用 Web 部件控件集提供的其他 EditorPart 控件。这些控件包括 BehaviorEditorPart、LayoutEditorPart 和 PropertyGridEditorPart 控件。内置 EditorPart 控件提供了 WebPart 控件的常用编辑功能。还可以通过从 EditorPart 类继承来创建自定义编辑器控件。有关代码示例,请参见 System.Web.UI.WebControls.WebParts.EditorPart。
启用 AppearanceE ......
BehaviorEditorPart Web 服务器控件是一个编辑器部件控件,最终用户可以使用该控件在运行时更改关联的 WebPart 控件上的多个用户界面 (UI) 属性。下表列出了用户可自定义的功能,以及用户可使用 BehaviorEditorPart 控件编辑的对应的 WebPart 控件属性值。
用户可自定义的功能
WebPart 控件属性
设置 Web 部件的说明文本。
· Description
设置标题链接。
· TitleUrl
设置标题图标图像链接。
· TitleIconImageUrl
设置目录图标图像链接。
· ......
Web 部件控件(例如 CatalogZone 控件)的一项主要功能是可以让最终用户个性化网页并保存其个性化设置。CatalogZone 控件允许最终用户在运行时向 Web 部件页添加 WebPart 控件或其他服务器控件。CatalogZone 控件用作 Web 部件控件集内的主控件,用于在网页中承载 CatalogPart 控件。
启用 CatalogZone Web 服务器控件
仅当用户将网页切换至目录显示模式 (CatalogDisplayMode) 时,CatalogZone 控件才变为可见。有关演示如何使用 CatalogZone 控件的代码示例,请参见 CatalogZone Web 服务器控件声明性语法和 System.Web.UI.WebControls.WebParts.CatalogZone 中的示例。
CatalogZone Web 服务器控件附带的 CatalogPart 控件
由 CatalogZone 控件创建的区域可以包含多种 CatalogPart 控件。每个 CatalogPart 控件都是一种容器,其中包含用户可添加至页面的服务器控件。CatalogPart 控件因其包含的服务器控件的来源而不同。
一、CatalogZone 类
在 Web 部件控件集中,区域是指网页上包含 Web 部件控件的某个区域。Web 部件区域由区域控件创建,区域控件是一种设计用来包 ......
使用 Web 部件控件,可以让用户在运行时创建两个服务器控件之间的连接,以形成连接并共享数据。一个控件用作数据的提供者,另一个控件用作数据的使用者。这两个控件可以是 WebPart 控件或任何其他类型的服务器控件。必须将它们设计为处理连接且位于 WebPartZoneBase 区域中。
在配置控件以形成 Web 部件连接之后,仍需要连接这些控件。连接控件的方法有:
·在网页中声明连接。
·用代码创建连接。
·将 ConnectionsZone 控件添加到页中,以便用户可以根据需要连接控件。
ConnectionsZone 控件生成 UI,以便用户能够连接任何合格控件或断开此类连接。该控件为可选控件,它不是形成连接所必需的。不过,如果想赋予用户有关连接或断开服务器控件的控制权,该控件将很有用。
通过 ConnectionsZone 控件控制的 Web 部件控件属性
ConnectionsZone 控件提供的用户界面能让用户设置与指定的使用者控件和指定的提供者控件相关的 ConnectionPoint 对象。
启用 ConnectionsZone 控件
作为一个工具区域,ConnectionsZone 控件被设计为仅当网页处于连接模式时可见。(当页上的 WebPartMana ......
Web 部件的一项主要功能是使最终用户能够个性化网页并保存其个性化设置。修改 Web 部件页的一个方面包括编辑可见 WebPart 控件的外观、布局、行为和其他属性。
Web 部件控件集中的几种控件可提供编辑功能。其中包括 EditorZone 控件,该控件是 Web 部件控件集中用于承载网页上的 EditorPart 控件的主控件。
下表提供了可由 EditorZone 承载的 EditorPart 控件列表以及每个控件的说明。
EditorPart 控件
说明
AppearanceEditorPart
允许用户在运行时自定义 WebPart 控件的视觉属性,例如宽度、高度和标题。
BehaviorEditorPart
允许用户在运行时自定义 WebPart 控件的行为属性,例如显示最小化、关闭和编辑按钮。
LayoutEditorPart
允许用户在运行时自定义 WebPart 控件的布局属性,例如选择最小化或正常状态,或设置控件将出现在目标区域中的位置的索引。
PropertyGridEditorPart
允许用户在运行时编辑已声明为 WebPart 控件的一部分的自定义属性。
当用户将 Web 部件页置于编辑模式时,EditorZone 控件将变为可见的。
EditorZone Web 服务器控件是一个区域控件。
一、Edito ......
ImportCatalogPart Web 服务器控件可导入 WebPart 控件的说明文件(或用作 WebPart 控件的其他 ASP.NET 服务器控件)。这样就可以将该控件通过预先指定的设置添加到网页中。该说明文件使用户可以共享 WebPart 控件的设置。
说明文件与控件本身不同。它是以 .WebPart 文件扩展名结尾的 XML 文件,包含有描述控件的状态的名称/值对。除了描述控件的状态以外,说明文件还引用该控件名和包含该控件的程序集(或文件)。
用户导入说明文件之后,该文件中引用的 WebPart 控件将会显示在 ImportCatalogPart 控件中,用户可以将该控件添加到页面中。
将 Web 部件控件与 ImportCatalogPart Web 服务器控件关联
与 ImportCatalogPart 控件关联的 Web 部件控件可以编译为程序集,也可以是一个用户控件(.ascx 文件)。在任一情况下,导入的说明文件中引用的控件都必须存在于包含宿主网页的 Web 服务器上。
用户可使用 ImportCatalogPart 控件将说明文件及其关联的服务器控件导入网页。此控件必须已存在于页面中。如果用户将页面切换到目录显示模式,则显示 ImportCatalogPart 控件。然后,用户就可以浏览到该控件的 .WebPart 说明文件,并 ......