Share via

LabelText 和 Text XML 元素引用

  • 项目

更新：2011 年 5 月

可以使用 LabelText 元素向工作项窗体添加独立标签或信息性文本。 该标签不与任何工作项字段相关联。 可以选择将超链接添加到部分或全部文本中。

LabelText 元素是 Control 元素的子元素。

架构层次结构

WITD

   WORKITEMTYPE

       FORM

           布局

               组

               列

               TabGroup

                  Tab

                     控件

<LabelText>
   <Text>
      <Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
         <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
      </Link>
      LabelText
   </Text>
</LabelText>

特性和元素

以下几节描述了属性、子元素和父元素。

子元素和特性

元素

说明

LabelText

type="LabelControl" 时，必需的 Control 元素。

独立标签或信息性文本的容器元素。 元素类型是复杂类型：LabelElementType。

该元素改写 Control 元素指定的 Label 特性指定的值。

Text

必需的 LabelText 元素。

要在工作项窗体上显示的信息或标签的容器元素。 如果 Link 元素在标签内指定，则元素内文本的一部分为超链接。 如果未指定 Link 元素，则呈现文本时不会带超链接。

标签文本的不同部分可以是有不同 url 的超链接。 可以在序列中指定多个文本元素值。

元素类型是复杂类型：TextElementType。

如果未指定 Text 元素，则 Control 元素 Label 特性文本会显示在工作项表单上。

Link

可选的 Text 元素。

将应用于字段的超链接或显示在工作项窗体上的独立标签的容器元素。 元素类型未 HyperLinkType。

注意注意
必须在 Control 元素中指定 Label 特性，前提是在您指定子 Link 元素时。

有关更多信息，请参见 Link 和 Param XML 元素引用。

父元素

元素

说明

控件

必选。 定义要在工作项窗体上显示的字段、文本、超链接或其他控件元素。

备注

可以通过在 LabelText 元素中添加多个 Text 元素来组合普通和超链接的文本。

LabelText 元素仅由正在运行最新版本的 团队资源管理器 客户端识别。 因此，必须在 Control 元素中指定 Label 特性。 对于运行 团队资源管理器 最新版本的客户端，LabelText 元素提供的文本会在工作项窗体中显示。 对于运行 团队资源管理器 早期版本的客户端，Control 元素 Label 特性指定的文本会在工作项窗体中显示。

示例：独立标签

说明

以下示例向工作项窗体添加纯文本“输入有关如何在下面的空间重现错误的详细信息：”。

代码

<Control Type="LabelControl" Label=" Enter details about how to reproduce the bug in the space below:">
   <LabelText>
      <Text>Enter details about how to reproduce the bug in the space below:
      </Text>
   </LabelText>
</Control>

示例：带超链接的独立标签

说明

下面的示例在工作项表单中添加一个超链接，其标有“如何使用此工作项？”。

代码

<Control Type="LabelControl" Label="How do I use this work item?">
   <LabelText>
      <Text>
   <Link UrlRoot="http://www.live.com"></Link>
      How do I use this work item?
      </Text>
   </LabelText>
</Control>

示例：应用于文本部分的超链接

说明

下面的示例将两部分标签添加到工作项表单。 第一部分“迭代路径”是与超链接相关联的。 第二部分“（必须为 3 级）”在工作项表单上显示为纯文本。

代码

<Control Type="FieldControl" FieldName="System.IterationPath" LabelPosition="Left">
   <LabelText>
      <Text>
         <Link UrlRoot="@WssSiteUrl/render.aspx?wit=bug&amp;topic=Iteration">
         </Link>
      Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

架构定义

您可以从 Microsoft 网站上的以下页面下载定义工作项类型的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（Visual Studio Team Foundation 的过程模板和工作项架构）。 有关如何使用架构文件的更多信息，请参见 Microsoft 网站上的以下页面：Using the Schemas to Edit Work Item Types and Process Templates for Team Foundation in Visual Studio（使用架构编辑 Visual Studio Team Foundation 的工作项类型和过程模板）。

元素：LabelText

<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />

复杂类型：LabelElementType

<xs:complexType name="LabelElementType">
   <xs:sequence>
      <xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
   </xs:sequence>
</xs:complexType>

复杂类型：TextElementType

<xs:complexType name="TextElementType" mixed="true">
   <xs:sequence>
      <xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
   </xs:sequence>
</xs:complexType>

请参见

概念

指定工作项窗体控件

设计和自定义工作项窗体

其他资源

Elements (Work Item Type Definition Schema)

修订记录

Date

修订记录

原因

2011 年 5 月

更正了为元素 Link 指定的 UrlPath 特性的语法。

内容 Bug 修复

2011 年 3 月

更正了一个示例和大多数元素的事例结构。 添加了有关可从何处访问架构文件的信息。

客户反馈

2011 年 1 月

移除了指向已移除主题的链接。

信息补充。