Web-Part的使用
合集下载
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
用于为不是 WebPart 控件的服务器控件配 置 Web 部件功能，以使任何 控 件、自定义控件或用户控件都可参与 Web 部件应用程序
从不在页标记中进行声明。它只用于在运 行时封装服务器控件，以使被封装的控件 （或子控件）具有 WebPart 控件的全部功 能
将其子控件包括并集成到 Web 部件个性 化设置进程中，以使其可充当真正的 WebPart 控件。这些都是自动进行的，从 而使得开发人员可以更方便地在 Web 部 件应用程序中使用服务器控件和用户控件
通过对WebPart类的继承创建Web部件
使用WebPart类 通过继承WebPart类实现Web部件，按照功能的 要求实现和重载其部分属性和方法 在应用中引用Web部件
Web部件的个性化
概述 在Web部件中的个性化
概述
个性化设置的工作方式 个性化设置和其他 功能 个性化设置中的主要概念 基本的个性化设置组件
通过AppearanceEditorPart设置Web部件的呈现样式
AppearanceEditorPart
Title
用于设置部件控件标题文本
ChromeType 用于选择所使用的标题和边框选 项的类型
Direction 用于选择内容在页上的流动方向
Height
用于设置高度，包括数值和单位
Width Hidden
类似于真正的 WebPart 控件或标准 控件，可在运行时以编程方式进 行访问（通过使用 GetGenericWebPart 方 法并向其传递子服务器控件）
WebPart 控件
用于创建内置本机 Web 部件功能 的自定义 控件。这些功 能包括个性化设置、连接、导入 和导出以及拖放功能 可在设计时在页标记中声明，如 服务器控件，但在 WebPartZoneBase 区域内进行声 明的除外 自动包括在 Web 部件个性化设置 进程中
Web 部件体系结构
UI（用户界面）结构组件依赖于个性化设置，并提 供所有 Web 部件控件需要的核心结构和服务
用户界面结构组件WebPartManager是所有 Web 部件 页必需的，尽管该控件从不可见，但它执行着协调 页面上所有 Web 部件控件的重要任务
另外一种用户界面结构组件是区域部件，区域充当 Web 部件页上的布局管理器
行为属性是指用户界面的一些操作行为，对于Web部件 而言，包括：
导入/导出 关闭部件 编辑部件 最小化 如果正在编辑的 WebPart 控件的 IsShared 属性值为 true， 并且页处于用户个性化设置范围内则不显示该控件。在 这种情况下，通常需要执行两个步骤显示该控件： 向 Web.config 文件添加项，该项提供授权用户权限 在运行时以编程方式将页从用户级别更改为共享级
WebPartPersonalization 实现执行个性化设置操作所必需的逻辑
在Web部件中的个性化
为成员资格配置站点 选择提供程序 创建Web 部件页 启用/禁用 Web 部件个性化设置 为Web部件属性启用个性化
该属性必须是公共的并且必须具有公共的 get 访问器和 set 访问器
该属性必须是读/写属性 该属性不能带有参数 该属性不能被索引
类似于标准 控件，可在 运行时以编程方式进行访问
完整的Web应用开发
完整的Web应用开发是指全面使用Web部件技术构 建完全集成和可个性化设置的Web应用或门户站点。 包括：
一组提供站点所需功能的 Web 部件控件 一组使最终用户可以一致地对用户界面进行个
性化设置的一致主题和样式 Web 部件控件目录（用户可以从中选择要显示
页个性化设置范围 控件可见性 属性范围
控（默 授权用户可以为所有用户对 认情况下共享 控件上的共享和用户范围的 WebPart 控件） 属性同时进行个性化设置。
对于动态控件（以编程方式 或从控件目录添加到页的控 件），授权用户可以为所有 用户永久地删除它。 对于静态控件（在 .aspx 页 的标记中声明的控件），尽 管授权用户可以为所有用户 关闭该控件，但不能将其删 除
Web 部件用户界面控件都从 Part 类派生，这些控件 构成了 Web 部件页上的主要用户界面
Web部件页
Web部件区域 Web部件管理器 Web部件页显示模式
Web部件区域
Web 部件区域是包含服务器控件或Web部件的容器， 它的一个重要作用就是启用其包含的控件的全部 Web 部件功能 每个 Web 部件页至少包含一个区域，并且每个区域 可以包含多个部件控件 区域对于 Web 部件功能来说是必需的
用于设置宽度，包括数值和单位 用于指示该控件是否已隐藏
通过LayoutEditorPart设置Web部件的呈现样式
LayoutEditorPart
ChromeState 获取或设置部件控件是处于最小 化状态还是正常状态
Zone
获取当前包含 WebPart 控件的 WebPartZoneBase 区域
使用Web部件
内容
Web部件 Web部件页 创建和使用Web部件
Web部件
Web部件概述 Web 部件体系结构
Web部件概述
源于SharePoint，在 2.0中进一步发展 应用很广泛，特别适合实现企业内部门户站点 在中，使用 Web 部件可以实现以下功能：
对页内容进行个性化设置 对页面布局进行个性化设置 导出和导入控件 创建连接 对站点级设置进行管理和个性化设置
跟踪 Web 部件控件 添加和删除 Web 部件控件 管理连接 对控件和页进行个性化设置 在不同页面视图之间切换 触发 Web 部件生命周期事件 启用控件的导入和导出
Web部件页显示模式
在Web部件页面中，我们常常需要对Web部件进行 各种管理和设置工作，可以通过设置页面的显示模 式来实现 一个页一次只能处于一种显示模式中 显示模式包括：
编辑和设置Web部件
对Web部件进行设置和编辑 通过AppearanceEditorPart和LayoutEditorPart设置Web 部件的呈现样式 使用PropertyGridEditorPart设置Web部件自定义属性 使用BehaviorEditorPart编辑Web部件其他行为属性 使用ImportCatalogPart添加Web部件
别个性化设置范围
使用ImportCatalogPart添加Web部件
当WebPart关闭后，可以使用ImportCatalogPart添加
Web部件连接
Web部件连接概念 连接的工作原理
Web部件连接概念
Web 部件连接是两个服务器控件之间的链接或关联， 使二者可以共享数据 一个连接涉及两个控件：一个是数据提供者，另一 个是数据使用者 连接始终出现在 Web 部件应用程序的上下文中，这 意味着除了参与连接的两个服务器控件外，网页中 还要求有两个其他控件 在连接关系中，使用者和提供者都具有至少一个称 为“连接点”的关联对象 要形成连接，使用者和提供者必须都能识别相同类 型的数据，这些数据在 Web 部件连接中通过接口实 例传递 创建连接后，它包含在 WebPartConnection 对象中
BrowseDisplayMode DesignDisplayMode EditDisplayMode CatalogDisplayMode ConnectDisplayMode
创建和使用Web部件
创建和使用Web部件的方法 创建和使用Web部件 Web部件的个性化 编辑和设置Web部件 Web部件连接
个性化设置是 Web 部件的一项功能，但必须在 WebPartZone 中使用控件
个性化设置不同于视图状态 Web部件的个性化设置不同于个性化配置(Profile)。
Web部件的个性化设置只存储特定网页上控件的 用户特定的状态数据
个性化设置中的主要概念
当对 Web 部件控件使用个性化设置时，应了解影响 个性化设置工作方式的几个概念：
需要实现页面编辑和设置功能 充分考虑系统功能的合理性
Web部件控件开发
Web部件控件开发又分为两种方法： 直接使用现有的 控件，系统使用 GenericWebPart对其进行封装，使其具有WebPart 的功能 创建从 WebPart 类派生的自定义 Web 部件控件
GenericWebPart 控件
区域的类型 WebPartZoneBase 区域
WebPartZone
ToolZone区域
EditorZone CatalogZone ConnectionsZone
区域包括： 标头 主体 镶边 部件控件 脚注
Web部件管理器
Web部件管理器（WebPartManager）在Web部件页上 是必需和唯一的，在整个页面上Web部件管理器作 为Web部件的控制中心。WebPartManager 控件可执 行下列任务：
单个用户可以自己对该控件的共享 和用户范围的可个性化属性同时进 行个性化设置，因为该控件实例完 全是私有的。 单个用户还可以永久地删除该控件
基本的个性化设置组件
Web 部件控件 WebPartManager
说明
管理页上的所有 Web 部件、启用或禁用 个性化设置以及管理个性化设置数据的 生命周期。每个 Web 部件页需要一个 （且只需要一个）WebPartManager 控件
个性化设置的工作方式
个性化设置使我们可以为 Web 部件控件创建具有数 个唯一特征的属性。可个性化的属性包括：
依赖于特定用户和网页的标识 长寿命 个性化设置使用 应用程序服务数据库
存储个性化设置数据 可在任意 Web 部件控件上声明
个性化设置和其他 功能
个性化设置在下列几个方面不同于用于保留 Web 应 用程序状态数据的其他 技术：
基于每个用户 的控件
当页位于共享范围时，不能 对该控件进行个性化设置， 因为该控件根本不出现在该 页上。只有当页位于用户范 围时，该控件才会出现
页位于用户范围中
单个用户不能对共享范围的属性进 行个性化设置。这些用户可以对用 户范围的属性进行个性化设置，并 且这些属性的值优先于页位于共享 范围时所分配的属性值。如果控件 上用户特定的个性化设置数据丢失 或重置，则用户范围的属性将恢复 为在页位于共享范围时所具有的值。 单个用户可以自己关闭共享控件（ 这会将该控件添加到页目录中）， 但不能永久地删除它
在页上的控件） 身份验证服务以及基于角色的管理（例如，允
许管理员用户为所有用户对 Web 部件控件和站 点设置进行个性化设置）
这种方式对我们开发工作的挑战极大
我们不但需要考虑应用程序的各个部分，还要根据 需要扩展 Web 部件控件以对环境提供更好的控制
这种方式也是最能体现Web部件特点的方式，一般 情况下可以使用这种方式构建复杂的个性化站点
创建和使用Web部件的方法
Web部件页开发 Web部件控件开发 完整的Web应用开发
Web部件页开发
在Visual Studio的设计视图中 进行设计，放置 WebPartManager和区域控件，并设计页面布局 在可视化设计器中，Web 部件控件集可提供拖放式 创建及配置 Web 部件控件的功能 值得注意的是：
ZoneIndex
获取 WebPart 控件在其区域内的 索引位置
使用PropertyGridEditorPart设置Web部件自定义属性
使用WebBrowsable、WebDisplayName、WebDescription这三个属 性设置是否在PropertyGridEditorPart中显示和显示的相关属性
属性 WebBrowsable
说明
在PropertyGridEditorPart 对象中是否显示 Web 部 件控件的指定属性
WebDisplayName 定义 Web 部件控件属性的友好名称
WebDescription
定义作为 Web 部件控件属性的工具提示使用的 字符串值
使用BehaviorEditorPart编辑Web部件其他行为属性
从不在页标记中进行声明。它只用于在运 行时封装服务器控件，以使被封装的控件 （或子控件）具有 WebPart 控件的全部功 能
将其子控件包括并集成到 Web 部件个性 化设置进程中，以使其可充当真正的 WebPart 控件。这些都是自动进行的，从 而使得开发人员可以更方便地在 Web 部 件应用程序中使用服务器控件和用户控件
通过对WebPart类的继承创建Web部件
使用WebPart类 通过继承WebPart类实现Web部件，按照功能的 要求实现和重载其部分属性和方法 在应用中引用Web部件
Web部件的个性化
概述 在Web部件中的个性化
概述
个性化设置的工作方式 个性化设置和其他 功能 个性化设置中的主要概念 基本的个性化设置组件
通过AppearanceEditorPart设置Web部件的呈现样式
AppearanceEditorPart
Title
用于设置部件控件标题文本
ChromeType 用于选择所使用的标题和边框选 项的类型
Direction 用于选择内容在页上的流动方向
Height
用于设置高度，包括数值和单位
Width Hidden
类似于真正的 WebPart 控件或标准 控件，可在运行时以编程方式进 行访问（通过使用 GetGenericWebPart 方 法并向其传递子服务器控件）
WebPart 控件
用于创建内置本机 Web 部件功能 的自定义 控件。这些功 能包括个性化设置、连接、导入 和导出以及拖放功能 可在设计时在页标记中声明，如 服务器控件，但在 WebPartZoneBase 区域内进行声 明的除外 自动包括在 Web 部件个性化设置 进程中
Web 部件体系结构
UI（用户界面）结构组件依赖于个性化设置，并提 供所有 Web 部件控件需要的核心结构和服务
用户界面结构组件WebPartManager是所有 Web 部件 页必需的，尽管该控件从不可见，但它执行着协调 页面上所有 Web 部件控件的重要任务
另外一种用户界面结构组件是区域部件，区域充当 Web 部件页上的布局管理器
行为属性是指用户界面的一些操作行为，对于Web部件 而言，包括：
导入/导出 关闭部件 编辑部件 最小化 如果正在编辑的 WebPart 控件的 IsShared 属性值为 true， 并且页处于用户个性化设置范围内则不显示该控件。在 这种情况下，通常需要执行两个步骤显示该控件： 向 Web.config 文件添加项，该项提供授权用户权限 在运行时以编程方式将页从用户级别更改为共享级
WebPartPersonalization 实现执行个性化设置操作所必需的逻辑
在Web部件中的个性化
为成员资格配置站点 选择提供程序 创建Web 部件页 启用/禁用 Web 部件个性化设置 为Web部件属性启用个性化
该属性必须是公共的并且必须具有公共的 get 访问器和 set 访问器
该属性必须是读/写属性 该属性不能带有参数 该属性不能被索引
类似于标准 控件，可在 运行时以编程方式进行访问
完整的Web应用开发
完整的Web应用开发是指全面使用Web部件技术构 建完全集成和可个性化设置的Web应用或门户站点。 包括：
一组提供站点所需功能的 Web 部件控件 一组使最终用户可以一致地对用户界面进行个
性化设置的一致主题和样式 Web 部件控件目录（用户可以从中选择要显示
页个性化设置范围 控件可见性 属性范围
控（默 授权用户可以为所有用户对 认情况下共享 控件上的共享和用户范围的 WebPart 控件） 属性同时进行个性化设置。
对于动态控件（以编程方式 或从控件目录添加到页的控 件），授权用户可以为所有 用户永久地删除它。 对于静态控件（在 .aspx 页 的标记中声明的控件），尽 管授权用户可以为所有用户 关闭该控件，但不能将其删 除
Web 部件用户界面控件都从 Part 类派生，这些控件 构成了 Web 部件页上的主要用户界面
Web部件页
Web部件区域 Web部件管理器 Web部件页显示模式
Web部件区域
Web 部件区域是包含服务器控件或Web部件的容器， 它的一个重要作用就是启用其包含的控件的全部 Web 部件功能 每个 Web 部件页至少包含一个区域，并且每个区域 可以包含多个部件控件 区域对于 Web 部件功能来说是必需的
用于设置宽度，包括数值和单位 用于指示该控件是否已隐藏
通过LayoutEditorPart设置Web部件的呈现样式
LayoutEditorPart
ChromeState 获取或设置部件控件是处于最小 化状态还是正常状态
Zone
获取当前包含 WebPart 控件的 WebPartZoneBase 区域
使用Web部件
内容
Web部件 Web部件页 创建和使用Web部件
Web部件
Web部件概述 Web 部件体系结构
Web部件概述
源于SharePoint，在 2.0中进一步发展 应用很广泛，特别适合实现企业内部门户站点 在中，使用 Web 部件可以实现以下功能：
对页内容进行个性化设置 对页面布局进行个性化设置 导出和导入控件 创建连接 对站点级设置进行管理和个性化设置
跟踪 Web 部件控件 添加和删除 Web 部件控件 管理连接 对控件和页进行个性化设置 在不同页面视图之间切换 触发 Web 部件生命周期事件 启用控件的导入和导出
Web部件页显示模式
在Web部件页面中，我们常常需要对Web部件进行 各种管理和设置工作，可以通过设置页面的显示模 式来实现 一个页一次只能处于一种显示模式中 显示模式包括：
编辑和设置Web部件
对Web部件进行设置和编辑 通过AppearanceEditorPart和LayoutEditorPart设置Web 部件的呈现样式 使用PropertyGridEditorPart设置Web部件自定义属性 使用BehaviorEditorPart编辑Web部件其他行为属性 使用ImportCatalogPart添加Web部件
别个性化设置范围
使用ImportCatalogPart添加Web部件
当WebPart关闭后，可以使用ImportCatalogPart添加
Web部件连接
Web部件连接概念 连接的工作原理
Web部件连接概念
Web 部件连接是两个服务器控件之间的链接或关联， 使二者可以共享数据 一个连接涉及两个控件：一个是数据提供者，另一 个是数据使用者 连接始终出现在 Web 部件应用程序的上下文中，这 意味着除了参与连接的两个服务器控件外，网页中 还要求有两个其他控件 在连接关系中，使用者和提供者都具有至少一个称 为“连接点”的关联对象 要形成连接，使用者和提供者必须都能识别相同类 型的数据，这些数据在 Web 部件连接中通过接口实 例传递 创建连接后，它包含在 WebPartConnection 对象中
BrowseDisplayMode DesignDisplayMode EditDisplayMode CatalogDisplayMode ConnectDisplayMode
创建和使用Web部件
创建和使用Web部件的方法 创建和使用Web部件 Web部件的个性化 编辑和设置Web部件 Web部件连接
个性化设置是 Web 部件的一项功能，但必须在 WebPartZone 中使用控件
个性化设置不同于视图状态 Web部件的个性化设置不同于个性化配置(Profile)。
Web部件的个性化设置只存储特定网页上控件的 用户特定的状态数据
个性化设置中的主要概念
当对 Web 部件控件使用个性化设置时，应了解影响 个性化设置工作方式的几个概念：
需要实现页面编辑和设置功能 充分考虑系统功能的合理性
Web部件控件开发
Web部件控件开发又分为两种方法： 直接使用现有的 控件，系统使用 GenericWebPart对其进行封装，使其具有WebPart 的功能 创建从 WebPart 类派生的自定义 Web 部件控件
GenericWebPart 控件
区域的类型 WebPartZoneBase 区域
WebPartZone
ToolZone区域
EditorZone CatalogZone ConnectionsZone
区域包括： 标头 主体 镶边 部件控件 脚注
Web部件管理器
Web部件管理器（WebPartManager）在Web部件页上 是必需和唯一的，在整个页面上Web部件管理器作 为Web部件的控制中心。WebPartManager 控件可执 行下列任务：
单个用户可以自己对该控件的共享 和用户范围的可个性化属性同时进 行个性化设置，因为该控件实例完 全是私有的。 单个用户还可以永久地删除该控件
基本的个性化设置组件
Web 部件控件 WebPartManager
说明
管理页上的所有 Web 部件、启用或禁用 个性化设置以及管理个性化设置数据的 生命周期。每个 Web 部件页需要一个 （且只需要一个）WebPartManager 控件
个性化设置的工作方式
个性化设置使我们可以为 Web 部件控件创建具有数 个唯一特征的属性。可个性化的属性包括：
依赖于特定用户和网页的标识 长寿命 个性化设置使用 应用程序服务数据库
存储个性化设置数据 可在任意 Web 部件控件上声明
个性化设置和其他 功能
个性化设置在下列几个方面不同于用于保留 Web 应 用程序状态数据的其他 技术：
基于每个用户 的控件
当页位于共享范围时，不能 对该控件进行个性化设置， 因为该控件根本不出现在该 页上。只有当页位于用户范 围时，该控件才会出现
页位于用户范围中
单个用户不能对共享范围的属性进 行个性化设置。这些用户可以对用 户范围的属性进行个性化设置，并 且这些属性的值优先于页位于共享 范围时所分配的属性值。如果控件 上用户特定的个性化设置数据丢失 或重置，则用户范围的属性将恢复 为在页位于共享范围时所具有的值。 单个用户可以自己关闭共享控件（ 这会将该控件添加到页目录中）， 但不能永久地删除它
在页上的控件） 身份验证服务以及基于角色的管理（例如，允
许管理员用户为所有用户对 Web 部件控件和站 点设置进行个性化设置）
这种方式对我们开发工作的挑战极大
我们不但需要考虑应用程序的各个部分，还要根据 需要扩展 Web 部件控件以对环境提供更好的控制
这种方式也是最能体现Web部件特点的方式，一般 情况下可以使用这种方式构建复杂的个性化站点
创建和使用Web部件的方法
Web部件页开发 Web部件控件开发 完整的Web应用开发
Web部件页开发
在Visual Studio的设计视图中 进行设计，放置 WebPartManager和区域控件，并设计页面布局 在可视化设计器中，Web 部件控件集可提供拖放式 创建及配置 Web 部件控件的功能 值得注意的是：
ZoneIndex
获取 WebPart 控件在其区域内的 索引位置
使用PropertyGridEditorPart设置Web部件自定义属性
使用WebBrowsable、WebDisplayName、WebDescription这三个属 性设置是否在PropertyGridEditorPart中显示和显示的相关属性
属性 WebBrowsable
说明
在PropertyGridEditorPart 对象中是否显示 Web 部 件控件的指定属性
WebDisplayName 定义 Web 部件控件属性的友好名称
WebDescription
定义作为 Web 部件控件属性的工具提示使用的 字符串值
使用BehaviorEditorPart编辑Web部件其他行为属性