ASP.NET Web 部件控件的描述文件

最新推荐文章于 2024-07-29 19:32:51 发布
最新推荐文章于 2024-07-29 19:32:51 发布
阅读量68 收藏
点赞数
文章标签： ui
原文链接：http://www.cnblogs.com/Laeb/archive/2007/01/07/614158.html
版权

Web 部件控件的描述文件是一个扩展名为 .WebPart 的 XML 文件，它包含有属性值、状态数据、以及从 WebPart 控件（或者是用在 Web 部件应用程序中的其它 ASP.NET 服务器或用户控件）所导出的的汇编集或源文件的详细内容。Web 部件的导入特征通过使用描述文件来为 Web 部件页面导入控件的描述，并使用已保存的数据来配置被导入的控件。该文章对描述文件中所包括的基本结构以及 XML 元素进行描述。 

<webParts>
  <webPart>
    <metaData>
      <type …/>
      <importErrorMessage .../>
    </metadata>
    <data>
      <properties>
        <ipersonalizable>
          <property …/>
        </ipersonalizable>
        <property …/>
      </properties>
      <genericWebPartProperties>
        <ipersonalizable>
          <property …/>
        </ipersonalizable>
        <property …/>
      </genericWebPartProperties>
    </data>
  </webPart>
</webParts>
备注

下表列出了能够被 Web 部件描述文件所包括的每个元素（以缩进的格式显示这些元素的直接子元素），列出了元素中的任何现有参数，以及元素用途的概要。注意，如果控件实现了 IPersonalizable 接口，那么会出现适当的 <ipersonalizable> 子元素并且把已实现的属性当成 <property> 元素来进行包含；否则，文件中将不会出现 <ipsersonalizable> 元素。

元素参数概要
webParts
  webPart

无。

文件中的父元素；并且在每个文件中只能够出现一次。该元素的 XML 逻辑允许每个文件中可以包含多个 <webPart> 元素，但是作为演示，我们只实现了一个 <webPart> 元素。 

webPart
  metaData
  data

xmlns=
"http://
schemas.microsoft.com/
WebPart/
v3"

提示：这是一个拥有固定值的命名空间参数。

对状态和属性数据被包含在文件中的控件进行展示。作为演示，我们为每个文件只使用了一个 <webPart> 元素。 

metaData
  type
  importErrorMessage

无。

包含 <webPart> 元素的类型信息以及在导入过程出现错误时显示给用户的错误消息。每个 <webPart> 元素只能有一个实例。 

type

type 元素必须拥有一个已指定的 name 或者 src 参数，也能够同时被使用。如果同时使用这两个参数，将优先处理 name 参数。

name 参数由包含类型和（可选的）关于 <webPart> 元素的汇编集信息的字符串所组成。

src 参数提供用户控件的源文件路径。

列出某个包含 <webPart> 元素的汇编集的类型信息，或者由 <webPart> 元素所呈现的用户控件的源文件路径。 

importErrorMessage

无。

包含在导入过程中发生错误时显示给用户的错误消息内容。每个 <webPart> 元素只能有一个实例。 

data
  properties
  genericWebPartProperties

无。

包含 <webPart> 元素的状态和属性值的数据。每个 <webPart> 元素只能有一个实例。 

properties
  ipersonalizable
  property

无。

包含 <property> 元素，或者是单独的一个 <ipersonalizable> 元素（包含有 <property> 子元素），或者两者同时被包含。<properties> 元素始终能够被呈现，但是只有在 <webPart> 拥有可个性化属性的时候才能够拥有 <property> 子元素。每个 <webPart> 元素只能有一个实例。 

genericWebPartProperties
  ipersonalizable
  property

无。

包含一个 <property> 元素，或者是单独的一个 <ipersonalizable> 元素（包含有 <property> 子元素），或者两者同时被包含。这个元素只在控件与非继承自 WebPart 类的 <webPart> 元素通讯的时候才被呈现。每个 <webPart> 元素只能有一个实例。 

ipersonalizable
  property

无。

<properties> 元素和 <genericWebPartProperties> 元素的子元素。这个元素只在控件与实现了 IPersonalizable 接口的 <webPart> 元素通讯的时候才会出现。它能够包含一个或者多个 <property> 子元素。每个 <webPart> 元素只能有一个实例。 

property

<property> 元素有三个参数：name、type、以及 null。其中 name 和 type 参数是必需的；而 null 参数只在属性拥有空值的时候才被使用。

name 参数是与 <webPart> 元素通讯的控件的特定属性的名称。

null 参数能够获取 true 值或者 false 值；它只在属性拥有空值的时候才被使用，以区别于来自于空字符串（""）的值。

type 参数用于识别 name 参数中被引用的属性的 Type 属性。type 参数实际的值可以是一个完整的类型名称，或者是使用下面所列的类型名称的缩写。

  • string

  • int

  • bool

  • double

  • single

  • datetime

  • color

  • unit

  • fontsize

  • object

  • direction （展示 ContentDirection）

  • helpmode （展示 WebPartHelpMode）

  • chromestate （展示 PartChromeState）

  • chrometype （展示 PartChromeType）

  • exportmode （展示 WebPartExportMode）

<properties>、<genericWebPartProperties>、以及 <ipersonalizable> 元素的子元素。这个元素为每个属性的值或者 <webPart> 元素中的状态数据项而包含“name/value”对。属性的实际数据则被包含在 <property> 元素的标记中，并且属性项的名称和类型由参数所指定。在包含它们的这三个类型的父元素中能够存在零个或者多个 <property> 元素。

实例

下列代码实例演示了两个在 Web 部件应用程序中导出控件实例的 .WebPart 描述文件。第一个实例显示了一个继承自 WebPart 基类的控件的源文件。注意它的属性数据全部被包含在 <properties> 元素中。第二个实例显示了一个没有继承自 WebPart 类的 ASP.NET 服务器控件的源文件。注意它的属性数据全部被包含在 <genericWebPartProperties> 元素中。 

<!-- 由 System.Web.UI.WebControls.WebParts.WebPart 控件所导出的文件。 -->
<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="http://schemas.microsoft.com/WebPart/v3">
    <metaData>
      <type name="Samples.AspNet.CS.Controls.TextDisplayWebPart, 
        App_Code.zq0cecf5, Version=0.0.0.0, Culture=neutral, 
        PublicKeyToken=null" />
      <importErrorMessage>
        Cannot import this Web Parts control.
      </importErrorMessage>
    </metaData>
    <data>
      <properties>
        <property name="AllowClose" type="bool">True</property>
        <property name="Width" type="unit" />
        <property name="AllowMinimize" type="bool">True</property>
        <property name="ContentText" type="string" null="true" />
        <property name="AllowConnect" type="bool">True</property>
        <property name="ChromeType" type="chrometype">
          Default
        </property>
        <property name="TitleIconImageUrl" type="string" />
        <property name="Description" type="string" />
        <property name="Hidden" type="bool">False</property>
        <property name="TitleUrl" type="string" />
        <property name="AllowEdit" type="bool">True</property>
        <property name="Height" type="unit" />
        <property name="HelpUrl" type="string" />
        <property name="Title" type="string" />
        <property name="CatalogIconImageUrl" type="string" />
        <property name="Direction" type="direction">
          NotSet
        </property>
        <property name="ChromeState" type="chromestate">
          Normal
        </property>
        <property name="AllowZoneChange" type="bool">True</property>
        <property name="AllowHide" type="bool">True</property>
        <property name="HelpMode" type="helpmode">Navigate</property>
        <property name="ExportMode" type="exportmode">All</property>
      </properties>
    </data>
  </webPart>
</webParts>

<!-- 由位于 Web 部件区域中的 System.Web.UI.WebControls.BulletedList 控件所导出的文件。 -->
<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="http://schemas.microsoft.com/WebPart/v3">
    <metaData>
      <type name="System.Web.UI.WebControls.BulletedList, 
        System.Web, Version=2.0.0.0, Culture=neutral, 
        PublicKeyToken=b03f5f7f11d50a3a" />
      <importErrorMessage>
        Cannot import this Web Parts control.
      </importErrorMessage>
    </metaData>
    <data>
      <properties />
      <genericWebPartProperties>
        <property name="AllowClose" type="bool">True</property>
        <property name="Width" type="unit" />
        <property name="AllowMinimize" type="bool">True</property>
        <property name="AllowConnect" type="bool">True</property>
        <property name="ChromeType" type="chrometype">
          Default
        </property>
        <property name="TitleIconImageUrl" type="string" />
        <property name="Description" type="string" />
        <property name="Hidden" type="bool">False</property>
        <property name="TitleUrl" type="string" />
        <property name="AllowEdit" type="bool">True</property>
        <property name="Height" type="unit" />
        <property name="HelpUrl" type="string" />
        <property name="Title" type="string">
          Favorite Links
        </property>
        <property name="CatalogIconImageUrl" type="string" />
        <property name="Direction" type="direction">
          NotSet
        </property>
        <property name="ChromeState" type="chromestate">
          Normal
        </property>
        <property name="AllowZoneChange" type="bool">
          True
        </property>
        <property name="AllowHide" type="bool">True</property>
        <property name="HelpMode" type="helpmode">
          Navigate
        </property>
        <property name="ExportMode" type="exportmode">
          All
        </property>
      </genericWebPartProperties>
    </data>
  </webPart>
</webParts>

转载于:https://www.cnblogs.com/Laeb/archive/2007/01/07/614158.html

weixin_34396902
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
ASP.NET自定义服务器控件
09-03
在ASP.NET中，自定义控件分为两种类型：类控件（Class Control）和Web部件（Web Control）。类控件是通过继承自`System.Web.UI.Control`类来创建的，而Web部件则继承自`System.Web.UI.WebControls.WebControl`类，后...
仿Winform而编写的工具栏和菜单控件源码asp.net
03-26
控件主要包括两个部件：工具栏和菜单 功能简简介： 支持式样设置 支持SCRIPT绑定 支持服务器端事件 SCRIPT绑定和服务器端事件功能可以一起设置，并不会产生冲突。 由于菜单是采用popupwindow方式弹出（并没有采用层...
【Asp.net】——Web控件与HTML控件的区别
努力成为自己的榜样。
06-12 1443
在看Asp.net视频的过程中，遇到对控件的一些解释，通过查询资料，简单的说说这二者的区别。
ASP.NET Web 部件控件集概览
VS_URL的专栏
05-10 695
ASP.NET Web 部件控件集概览 ASP.NET Web 部件控件集是一个相互工作组件集，它允许你创建能够让终端用户通过浏览器直接对用户界面（UI）的外观和行为进行更改的 Web 页面。该文章涵盖了 Web 部件的控件集的基本内容，其中包括对创建 Web 部件页面时所需要的 Web 部件基本组件集的描述。 Web 部件的组件目录 Web 部件的控件集由三个基本的部分组成
ASP.NET - Web 部件控件集概述
编程资料大全
01-05 132
ASP.NET Web 部件控件集是一组协同工作的组件，使您可以创建最终用户可以直接从浏览器修改其用户界面 (UI) 的外观和行为的网页。本概述涵盖了 Web 部件控件集的基本方面，包括最常用的控件以及创建 Web 部件页所需的基本 Web 部件组件的说明。 一、Web 部件组件的类别 Web 部件控件集由三个基本构造块组成：个性化设置功能、在页面上使用 Web 部件用户界面控件所需的...
【.NET全栈】ASP.NET开发Web应用——Web部件技术
JosieBook
07-18 618
ASP.NET中的Web组件技术，特别是Web部件（Web Parts），是一种用于创建允许终端用户直接通过浏览器修改网页内容、外观和行为的集成式控件集。这些控件提供了丰富的功能和灵活性，使得开发人员能够构建出高度可定制的Web应用程序。一、Web部件概述定义与功能ASP.NET Web部件是一组集成控件，用于创建网站，使最终用户可以直接从浏览器修改网页的内容、外观和行为。这些修改可以应用于网站上的所有用户或个别用户。
ASP.NET - ASP.NET Web 部件概述
编程资料大全
01-05 133
ASP.NET Web 部件是一组集成控件，用于创建网站使最终用户可以直接从浏览器修改网页的内容、外观和行为。这些修改可以应用于网站上的所有用户或个别用户。当用户修改页和控件时，可以保存这些设置以便跨以后的各浏览器会话保留用户的个人首选项，这种功能称为个性化设置。这些 Web 部件功能意味着开发人员可以使最终用户动态地对 Web 应用程序进行个性化设置，而无需开发人员或管理员的干预。 通...
【.NET全栈】ASP.NET开发Web应用——站点导航技术
JosieBook
07-15 879
大型的企业级网站，可能有成百上千个网页，导航变得十分重要。好的导航系统能够方便用户在多个页面间来回浏览，增加了应用程序的可交互性。ASP.NET提供了内置的导航技术，让开发人员创建站点导航变得轻松。ASP.NET中的站点地图用于导航的高级服务器控件TreeView菜单和导航服务器控件Menu站点地图是一个名为Web.sitemap的XML文件。
界面控件DevExpress ASP.NET Core v21.2 - 增强Tree List等控件
需要界面开发、IDE工具研发中文教程资料的小伙伴，记得私信我~
06-08 363
DevExpress ASP.NET Core v21.2已正式发布，此版本增强Data Grid、Tree List控件等功能，欢迎下载此版本体验~
这个三方控件，让你的ASP.NET应用图表界面更酷炫
需要界面开发、IDE工具研发中文教程资料的小伙伴，记得私信我~
03-12 597
DevExpress技术交流群3：700924826欢迎一起进群讨论 DevExpress ASP.NETWeb Forms Controls拥有针对Web表单（包括报表）的110+种UI控件，DevExpress ASP.NET MVC Extensions是服务器端MVC扩展或客户端控件，由轻量级JavaScript小部件提供支持的70+个高性能DevExpress ASP.NET Core Controls，包含功能完善的报表平台，DevExpress ASP.NET Web Form...
ASP.NET - ASP.NET Web 部件生命周期
编程资料大全
01-05 89
在将 ASP.NET Web 部件的集成控件集中的控件包括在网页中时，这些控件将遵守该页的规则；具体而言就是，这些控件将在该页的生命周期内运行。 每个网页都具有一个生命周期，网页在其生命周期内将执行一系列处理步骤。这些步骤包括初始化、创建控件、还原和维护状态、运行事件处理程序代码以及进行呈现。了解页面的生命周期及其应用于 Web 部件的方式具有重要意义，这样您才能在该周期中的适当阶段实现...
ASP.NET讲解-PPT.rar
09-05
在ASP.NET中，部件控件（Server Controls）是核心组件之一，它们提供了丰富的用户界面元素，如按钮、文本框、表格等，可以通过简单的属性配置实现复杂的交互功能。控件还支持事件处理，允许开发者编写响应用户操作的...
ASP.NET服务器控件与组件开发
11-02
ASP.NET服务器控件与组件开发是.NET框架中的一个重要部分，它是构建动态Web应用程序的关键技术。在ASP.NET中，服务器控件提供了一种直观且高效的方式来创建用户界面，并处理客户端与服务器之间的交互。开发者通过...
ASP.NET AJAX Control Toolkit 控件说明
03-18
ASP.NET AJAX Control Toolkit 是一个强大的库，为ASP.NET开发者提供了丰富的服务器端控件和扩展，以实现各种交互式和动态的用户体验。这个工具包包含了超过34种不同的控件和扩展，涵盖了从基本的用户界面增强到复杂...
QLabel 添加滚动条
qq_43287931的博客
07-24 335
在UI上拖拽label。
麦田物语第十五天
qq_52276934的博客
07-27 980
今天主要设计了时间的代码逻辑以及UI部分，明天要做的就是将这两部分连接起来即可。
Unity--UI事件触发器--EventTrigger
最新发布
qq_40669895的博客
07-29 573
Unity--UI事件触发器--EventTrigger
使用 Swagger 在 Golang 中进行 API 文档生成
小小的木头人的博客
07-24 626
Swagger 是一款强大的 API 文档生成工具，可以帮助开发者轻松创建、管理和展示 RESTful API 文档。在本文中，我们将介绍如何在 Golang 项目中使用 Swagger 来生成 API 文档。
ASP.NET 3.5服务器控件与AJAX组件实战指南
它旨在教授读者如何有效地利用ASP.NET 3.5中的功能来构建服务器控件，特别是涉及数据绑定的服务器控件、Web部件，以及ASP.NET AJAX服务器控件和扩展器。 在Asp.NET 3.5中，服务器控件是构建动态Web应用程序的关键...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值