LabelText 和 Text XML 元素引用
可以使用 LabelText 元素向工作项窗体添加独立标签或信息性文本。该标签不与任何工作项字段相关联。可以选择将超链接添加到部分或全部文本中。
LabelText 元素是 Control 元素的子元素。
架构层次结构
<LabelText>
<Text>
<Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
</Link>
LabelText
</Text>
</LabelText>
特性和元素
以下几节描述了特性、子元素和父元素。
.gif "Dd936113.collapse_all(zh-cn,VS.110).gif")
子元素和特性
元素 |
说明 |
|---|---|
LabelText |
type="LabelControl" 时，必需的 Control 元素。 独立标签或信息性文本的容器元素。元素类型是复杂类型：LabelElementType。 该元素改写 Control 元素指定的 Label 特性指定的值。 |
Text |
必需的 LabelText 元素。 要在工作项窗体上显示的信息或标签的容器元素。如果 Link 元素在标签内指定，则元素内文本的一部分为超链接。如果未指定 Link 元素，则呈现文本时不会带超链接。 标签文本的不同部分可以是有不同 url 的超链接。可以在序列中指定多个文本元素值。 元素类型是复杂类型：TextElementType。 如果未指定 Text 元素，则 Control 元素 Label 特性文本会显示在工作项表单上。 |
Link |
可选的 Text 元素。 将应用于字段的超链接或显示在工作项窗体上的独立标签的容器元素。元素类型未 HyperLinkType。 .gif "说明") 说明
必须在 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&topic=Iteration">
</Link>
Iteration Path
</Text>
<Text> (must be 3 levels deep)</Text>
</LabelText>
</Control>
架构定义
元素：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>