行元素 (dsQueryResponse)

适用于: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

表示列表中的一行数据。 该行包含的列表项的字段和元数据属性由 Row 元素的属性表示。 取决于其数据类型的某些字段可能由其他属性表示,从而以不同格式呈现字段的值。

<Row
  Attachments="Integer"
  ContentTypeId="GUID"
  File_x0020_Type="String"
  FileLeafRef="String"
  FileLeafRef.Name="String"
  FileLeafRef.Suffix="String"
  FSObjType="Integer"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapall="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapico="String"
  ID="Integer"
  PermMask="Hex"
  some_field="type appropriate to the field"
  some_booleanField.Value="Integer"
  some_date_time_field.ifnew="Integer"
  some_date_time_field.="unlocalized DateTime"
  some_date_time_field.DateOnly="date"
  some_date_time_field.TimeOnly="time"
  some_date_time_field.ISO8601="ISO8601 compliant DateTime"
  some_date_time_field.MonthDayOnly="month and day"
  some_date_time_field.MonthYearOnly="month and year"
  some_user_field="String"
  some_user_field.id="Integer"
  some_user_field.title="String"
  some_user_field.span="String"
  some_url_field.desc="String"
/>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
附件 必填。 如果列表项有一个或多个附件,则为 1;否则为 0
ContentTypeId 必填。 列表项内容类型的 GUID,格式为 Ox GUID_without_hyphens
File_x0020_Type 必需属性,但在列表不是文档库时可以忽略。 文件在文档库中的类型。 如果列表不是文档库,则为空字符串。
FileLeafRef 必需属性,但在列表不是文档库时可以忽略。 文档的相对于服务器的 URL。 这是文件夹名称,后跟 "_.",后跟文件名。 例如 QuarterlySummaries_.Quarter1.docx。 此属性值是 FileLeafRef.Name 属性的值与带"."分隔符的 FileLeafRef.Suffix 属性的值串联。
FileLeafRef.Name 必需属性,但在列表不是文档库时可以忽略。 包含文档的文件夹的名称,后跟下划线字符;例如, QuarterlySummaries_.
FileLeafRef.Suffix 必需属性,但在列表不是文档库时可以忽略。 文档文件的名称;例如 。 Quarter1.docx
FSObjType 必填。 如果列表项是文件夹,则为 1;否则为 0
HTML_x0020_File_x0020_Type.File_x0020_Type.mapall 可选。 通过在 XSLT 转换期间调用 MapToAll 函数返回的值。 有关详细信息,请参阅 ddwrt 命名空间中的 MapToAll 元素 (视图) SharePoint 数据视图 Web 部件扩展函数
HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon 可选。 通过在 XSLT 转换期间调用 MapToControl 函数返回的值。 有关详细信息,请参阅 MapToControl (SPWeb、String、String) MapToControl 元素 (View) dddwrt 命名空间中的 SharePoint 数据视图 Web 部件扩展函数
HTML_x0020_File_x0020_Type.File_x0020_Type.mapico 可选。 通过在 XSLT 转换期间调用 MapToIcon 函数返回的值。 有关详细信息,请参阅 Icon () MapToIcon 元素 (视图) ddwrt 命名空间中的 SharePoint 数据视图 Web 部件扩展函数
ID 必填。 列表项的 ID。
PermMask 列表项的权限掩码。
some_field 列表项中每个非隐藏字段的必需属性。 对于每个这样的字段,均有一个属性具有的名称与该字段的内部名称相同。
some_field 可选。 SharePoint Foundation 中的货币、数字和查阅字段类型可能具有低级格式,即使在应用任何 HTML 格式之前也是如此。 例如,负货币值括在括号中。 每个此类字段的属性后紧跟另一个具有相同名称的属性,其中追加了一个字符 "." 。 此属性可以原始无格式数据的形式提供字段值。 例如,负货币值由减号 ("-") 进行,并且不在括号中。
some_booleanField。价值 可选。 列表项中的每个 布尔 属性后跟另一个具有相同名称的属性(追加到该 ".Value" 属性)。 此属性可提供未本地化的原始形式的字段值(1 或 0),而 Boolean 字段的主属性可提供相对于网站场合的值。
some_date_time_field.ifnew 可选。 如果日期时间值是最近的值,足以将列表项定义为新值,则为 1;否则为 0。 此属性仅在 some_date_time_field 为“Created_x0020_Date”时显示。
some_date_time_field 可选。 如果日期/时间字段有一个属性,其值已本地化,则还会有一个具有相同名称的属性,该属性将向其追加一个字符 "." 。 此属性可提供以 ISO8601 格式存储在内容数据库中的 datetime 字段的原始值。
some_date_time_field。DateOnly 可选。 仅包含日期的 DateTime 字段的值。 仅用于与博客有关的列表。
some_date_time_field。TimeOnly 可选。 仅包含当天时间的 DateTime 字段的值。 仅用于与博客有关的列表。
some_date_time_field。ISO8601 可选。 格式符合 ISO8601 要求的 DateTime 字段的值。 仅用于与博客有关的列表。
some_date_time_field。MonthDayOnly 可选。 仅包含月份和月份日期的 DateTime 字段的值。 仅用于与博客有关的列表。
some_date_time_field。MonthYearOnly 可选。 仅包含年和月的 DateTime 字段的值。 仅用于与博客有关的列表。
some_user_field.id 可选。 如果任何属性表示“用户类型”字段,则会有另一个具有相同名称的属性(追加到该 ".id" 属性)。 这是用户的相对于网站的 ID 号。
some_user_field.title 可选。 如果任何属性表示“用户类型”字段,则会有另一个具有相同名称的属性(追加到该 ".title" 属性)。 这是用户名,例如“Michiyo Sato”。 请注意,主属性 (some_user_field) 的值是用户的 HTML span 标记,例如包括状态信息。 有关示例,请参阅表下面的代码摘录。
some_user_field.span 可选。 如果任何属性表示“用户类型”字段,则会有另一个具有相同名称的属性(追加到该 ".span"属性)。 对于用户来说,这是更普通的 HTML 标记。 有关示例,请参阅表下面的代码摘录。
some_url_field.desc 可选。 如有任何属性表示 URL 字段,则还有一个对其追加“.desc”的同名属性。 此属性可提供 URL 的说明。

未设置 ListViewWebPart.ViewFlags 属性的 FreeForm 标志时,此标记用于呈现字段;否则,使用 some_user_field.span 属性的值。

<span class="ms-imnSpan">
  <a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com'
         id='imn_1,type=smtp' />
  </a>
  <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
</span>

设置 ListViewWebPart.ViewFlags 属性的 FreeForm 标志时,此标记用于呈现字段;否则,使用 some_user_field.title 属性的值。

<nobr>
  <span>
    <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
    <img border="0" height="1" width="3" src="/_layouts/images/blank.gif"/><a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com' id='imn_2,type=smtp'/></a>
  </span>
</nobr>

子元素

父元素

出现次数

  • 最小值:0
  • 最大值:父 dsQueryResponse 元素的 RowLimit 属性的值

示例

有关示例,请参阅 Examples of Input and Result Node Trees in XSLT Transformations