MOSS之：DataForm Web Part解析

在SharePoint Designer中插入DataForm以后，你会发现它的代码部分由四大部分组成：

1）DataSources：数据源，可以是单数据源，多数据源链接，SharePoint也提供了各种数据源控件（XML，web服务，数据库，等等）。进行SharePoint中单数据列表操作的时候，用的是SPDataSource控件，本篇文章会主要介绍这个控件，另外将简要说明一下多数据源链接，及其应用场景。

2）ParameterBindings：Web Part的所有参数就包含在这里面

3）DataFields：可在Web Part上显示的所有数据域

4）XSL：XSLT，把数据源的数据转换成你想要的显示样式

DataForm的工作过程一般是这样的：

1）DataForm Web Part会首先处理参数Parameter，数据源中可能含有参数，以筛选数据，XSLT里面也可能有一些参数需要赋值，Web部件会把ParameteBindings块中的所有参数赋值给数据源和XSLT里面ParameterKey相同的参数；

2）然后，DataForm Web Part把数据源对应的数据取出来返回的XML格式数据；

<update>我们在SharePoint Designer里面看见的筛选窗口一般就是用来筛选数据源的，它会修改SPDatasource的Selectcommand属性</update>

3）最后，利用XSLT把数据源转换并返回给客户端。

<update>

我们在SharePoint Designer里面看见的筛选窗口的高级XPath筛选则是XSLT层次的筛选。

也就是说数据源筛选先进行，然后XSLT在逐条数据进行筛选，XSLT的筛选在数据量大的时候可能会影响性能。所以，没有特别的需求最好筛选数据源，不用XPath。

</update>

------

下面介绍一些DataSources，ParameterBindings和XSL相关的一些信息以及有用的链接：

1）DataSources

SPDataSource这个web控件有多种数据源模式：ListItem（单个列表项）, List（某个列表）, CrossList（跨列表）, ListofLists（列表集合，显示列表的信息）, Webs（网站的信息）

关于SPDataSource控件的信息，SharePoint Designer Team有一篇很好的Blog：SPDataSource and Rollups with the Data View

如果在ListItem和List模式下，DataForm Web Part中的SPDataSource必须要包含DataFormParameter，DataFormParameter是一个独立的参数类，DataForm Web Part用这个参数来定位数据源列表，同时DataFormParameter也只识别特定的ParameterKey：ListID，ListItemId，ListName，WebUrl等。

如果是ListItem模式下，必须要有（ListID or ListName) and ListItemId参数。

如果是List模式下，必须要有ListID 或者ListName参数。

技巧：如果你要迁移部署定制好的页面的话，你一定要使用ListName参数来定位列表。原因很简单，列表名称在迁移后不会变，但是ListID是会变化的。

在CrossList，ListofLists和Webs模式下的时候，SPDataSource的SelectCommand的写法和SPSiteDataQuery的查询规则相似。比如用<Lists></Lists>可以选择所有的当前网站的列表，以下是一个列出所有当前网站列表的例子：

<WebPartPages:DataFormWebPart runat="server" AllowConnect="True" PartImageSmall="" MissingAssembly="Can't exported"
 IsIncludedFilter="" ExportMode="All" ID="g_eea4c5ed_0ae5_498b_9840_32b8409212b8" AllowRemove="True" FrameState="Normal" 
ConnectionID="00000000-0000-0000-0000-000000000000" DetailLink="" ExportControlledProperties="True" IsIncluded="True" 
sVisible="True" AllowEdit="True" Dir="Default" SuppressWebPartChrome="False" ViewContentTypeId="" PageSize="-1" FrameType="Default"
 DataSourceID="" UseSQLDataSourcePaging="True" AllowHide="True" AllowMinimize="True" ShowWithSampleData="False" HelpMode="Modeless" 
ViewFlag="0" Title="test1" HelpLink="" Description="" PartOrder="2" AllowZoneChange="True" PartImageLarge="" NoDefaultStyle="TRUE" 
__MarkupType="vsattributemarkup" __WebPartId="{EEA4C5ED-0AE5-498B-9840-32B8409212B8}" __AllowXSLTEditing="true" WebPart="true" Height="" Width="">
<DataSources> <SharePoint:SPDataSource runat="server" SelectCommand="&lt;Lists&gt;&lt;/Lists&gt;" DataSourceMode="ListOfLists" 
UseInternalName="True" ID="dataformwebpart1"></SharePoint:SPDataSource> </DataSources> <ParameterBindings> 	
<ParameterBinding Name="dvt_apos" Location="Postback;Connection"/> 	<ParameterBinding Name="UserID" Location="CAMLVariable"
 DefaultValue="CurrentUserName"/> 	<ParameterBinding Name="Today" Location="CAMLVariable" DefaultValue="CurrentDate"/> 	
<ParameterBinding Name="ListName" Location="QueryString(ListName)" DefaultValue="test1"/> </ParameterBindings> 
<DataFields>@__spAlertTemplate,__spAlertTemplate;@__spAllowContentTypes,__spAllowContentTypes;@__spAllowDeletion,__spAllowDeletion;

@__spAllowMultiResponses,__spAllowMultiResponses;@__spAnonymousPermMask,__spAnonymousPermMask;@__spAnonymousPermMask64,__spAnonymousPermMask64;

@__spAudit,__spAudit;@__spAuthor,__spAuthor;@__spBaseTemplate,__spBaseTemplate;@__spBaseType,__spBaseType;@__spCanReceiveEmail,

__spCanReceiveEmail;@__spContentTypes,__spContentTypes;@__spContentTypesEnabled,__spContentTypesEnabled;@__spCreated,__spCreated;

@__spCurrentChangeToken,__spCurrentChangeToken;@__spDefaultView,__spDefaultView;@__spDefaultViewUrl,__spDefaultViewUrl;

@__spDescription,__spDescription;@__spDirection,__spDirection;@__spDraftVersionVisibility,__spDraftVersionVisibility;

@__spEffectiveBasePermissions,__spEffectiveBasePermissions;@__spEmailAlias,__spEmailAlias;@__spEnableAssignToEmail,__spEnableAssignToEmail;

@__spEnableAttachments,__spEnableAttachments;@__spEnableMinorVersions,__spEnableMinorVersions;@__spEnableModeration,__spEnableModeration;

@__spEnableSyndication,__spEnableSyndication;@__spEnableVersioning,__spEnableVersioning;@__spEventReceivers,__spEventReceivers;

@__spEventSinkAssembly,__spEventSinkAssembly;@__spEventSinkClass,__spEventSinkClass;@__spEventSinkData,__spEventSinkData;

@__spExcludeFromTemplate,__spExcludeFromTemplate;@__spFields,__spFields;@__spFirstUniqueAncestor,__spFirstUniqueAncestor;

@__spFlags,__spFlags;@__spForceCheckout,__spForceCheckout;@__spForms,__spForms;@__spHasExternalEmailHandler,__spHasExternalEmailHandler;

@__spHasUniqueRoleAssignments,__spHasUniqueRoleAssignments;@__spHidden,__spHidden;@__spID,__spID;@__spImageUrl,__spImageUrl;

@__spInternalName,__spInternalName;@__spItemCount,__spItemCount;@__spItems,__spItems;@__spLastItemDeletedDate,__spLastItemDeletedDate;

@__spLastItemModifiedDate,__spLastItemModifiedDate;@__spLists,__spLists;@__spMultipleDataList,__spMultipleDataList;

@__spOnQuickLaunch,__spOnQuickLaunch;@__spOrdered,__spOrdered;@__spParentWeb,__spParentWeb;@__spParentWebUrl,__spParentWebUrl;

@__spPermissions,__spPermissions;@__spProperties,__spProperties;@__spPropertiesXml,__spPropertiesXml;@__spReadSecurity,__spReadSecurity;

@__spReusableAcl,__spReusableAcl;@__spRoleAssignments,__spRoleAssignments;@__spRootFolder,__spRootFolder;@__spRootFolderUrl,__spRootFolderUrl;

@__spSchemaXml,__spSchemaXml;@__spSendToLocationName,__spSendToLocationName;@__spSendToLocationUrl,__spSendToLocationUrl;

@__spShowUser,__spShowUser;@__spTitle,__spTitle;@__spVersion,__spVersion;@__spViews,__spViews;@__spWorkflowAssociations,__spWorkflowAssociations;

@__spWriteSecurity,__spWriteSecurity;</DataFields> <Xsl> <xsl:stylesheet xmlns:x=http://www.w3.org/2001/XMLSchema
 xmlns:d="http://schemas.microsoft.com/sharepoint/dsp" version="1.0" exclude-result-prefixes="xsl msxsl ddwrt"
 xmlns:ddwrt="http://schemas.microsoft.com/WebParts/v2/DataView/runtime" xmlns:asp=http://schemas.microsoft.com/ASPNET/20 
xmlns:__designer="http://schemas.microsoft.com/WebParts/v2/DataView/designer" xmlns:xsl=http://www.w3.org/1999/XSL/Transform 
xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:SharePoint="Microsoft.SharePoint.WebControls" xmlns:ddwrt2="urn:frontpage:internal"> 
<xsl:output method="html" indent="no"/> 	<xsl:decimal-format NaN=""/> 	<xsl:param name="dvt_apos">&apos;</xsl:param> 	
<xsl:param name="ListName">test1</xsl:param> 	<xsl:variable name="dvt_1_automode">0</xsl:variable> 	<xsl:template match="/"
 xmlns:x="http://www.w3.org/2001/XMLSchema" xmlns:d=http://schemas.microsoft.com/sharepoint/dsp
 xmlns:asp="http://schemas.microsoft.com/ASPNET/20" xmlns:__designer=http://schemas.microsoft.com/WebParts/v2/DataView/designer 
xmlns:SharePoint="Microsoft.SharePoint.WebControls"> 	        <xsl:call-template name="dvt_1"/> 	</xsl:template> 	
<xsl:template name="dvt_1"> 		<xsl:variable name="dvt_StyleName">Table</xsl:variable> 	
<xsl:variable name="Rows" select="/dsQueryResponse/Rows/Row[@__spTitle=$ListName]"/> 		
<xsl:variable name="dvt_RowCount" select="count($Rows)" /> 		
<xsl:variable name="dvt_IsEmpty" select="$dvt_RowCount = 0" /> 		<xsl:choose> 	
<xsl:when test="$dvt_IsEmpty"> 				<xsl:call-template name="dvt_1.empty" /> 	
</xsl:when> 			<xsl:otherwise><table border="0" width="100%" cellpadding="2" cellspacing="0"> 	
<tr valign="top"> 				<xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1"> 
<th class="ms-vh" width="1%" nowrap="nowrap"></th> 				
</xsl:if><th class="ms-vh" nowrap="">__spTitle</th><th class="ms-vh" nowrap="">__spID</th></tr>     			       
<xsl:call-template name="dvt_1.body"> 				        <xsl:with-param name="Rows" select="$Rows"/> 	
</xsl:call-template> 		                </table></xsl:otherwise> 		</xsl:choose>
			 	</xsl:template> 	<xsl:template name="dvt_1.body"> 		<xsl:param name="Rows"/> 	
<xsl:for-each select="$Rows"> 			<xsl:call-template name="dvt_1.rowview"/> 		</xsl:for-each> 	
</xsl:template> 	<xsl:template name="dvt_1.rowview"> 		<tr> 			<xsl:if test="position() mod 2 = 1"> 
<xsl:attribute name="class">ms-alternating</xsl:attribute> 			</xsl:if><td class="ms-vb"> 
<xsl:value-of select="@__spTitle" /></td><td class="ms-vb"> 				
<xsl:value-of select="@__spID" /></td> 			<xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1"> 
<td class="ms-vb" width="1%" nowrap="nowrap"> 		
<span ddwrt:amkeyfield="ID" ddwrt:amkeyvalue="ddwrt:EscapeDelims(string(@ID))" ddwrt:ammode="view"></span> 
</td> 			</xsl:if> 			</tr> 	</xsl:template> 
<xsl:template name="dvt_1.empty"> 		<xsl:variable name="dvt_ViewEmptyText">Nothing</xsl:variable> 	
<table border="0" width="100%"> 			<tr> 				<td class="ms-vb"> 	
<xsl:value-of select="$dvt_ViewEmptyText" /> 				</td> 			</tr> 	
</table> 	</xsl:template> </xsl:stylesheet></Xsl> </WebPartPages:DataFormWebPart>

相关文章：

  • 2022-02-12
  • 2021-05-26
  • 2022-12-23
  • 2022-12-23
  • 2022-12-23
  • 2022-12-23
猜你喜欢
  • 2021-06-28
  • 2022-12-23
  • 2021-12-03
  • 2021-11-26
  • 2022-12-23
  • 2022-01-11
相关资源
相似解决方案
热门标签
Java Python linux javascript Mysql C# Docker 算法 前端 SpringBoot Redis Vue spring 设计模式 .net core .net kubernetes c++ 数据库 数据结构 大数据 js 机器学习 微服务 Android Go 程序员 面试 JVM ASP.net core 云原生 人工智能 后端 PHP git CSS golang k8s Nginx Django mybatis 深度学习 多线程 React 架构 devops 爬虫 云计算 Spring Boot LeetCode