XML-Elementreferenz für LabelText und Text

Sie können einem Arbeitsaufgabenformular eine eigenständige Bezeichnung oder Informationstext hinzufügen, indem Sie das LabelText-Element verwenden. Die Bezeichnung ist keinem Arbeitsaufgabenfeld zugeordnet. Optional können Sie an einen Teil des Texts oder den gesamten Text einen Link anfügen.

Das LabelText-Element ist ein untergeordnetes Element des Control-Elements.

Schemahierarchie

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppe

               Spalte

               TabGroup

                  Registerkarte

                     Steuerelement

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Untergeordnete Elemente und Attribute

Element	Beschreibungen
LabelText	Erforderliches Control-Element bei type="LabelControl". Containerelement für eine eigenständige Bezeichnung oder einen Informationstext. Der Elementtyp ist der komplexe Typ LabelElementType. Dieses Element überschreibt den Wert, der vom Label-Attribut angegeben wird, das wiederum vom Control-Element angegeben wird.
Text	Erforderliches LabelText-Element. Containerelement für die Informationen oder die Bezeichnung, die im Arbeitsaufgabenformular angezeigt werden. Wenn das Link-Element innerhalb der Bezeichnung angegeben ist, ist der Teil des Texts im Element durch einen Link verbunden. Wenn das Link-Element nicht angegeben ist, wird der Text ohne Link gerendert. Andere Teile des Bezeichnungstexts können mit verschiedenen URLs durch Link verbunden werden. Mehrere Textelementwerte können in einer Reihe angegeben werden. Der Elementtyp ist der komplexe Typ TextElementType. Wenn das Text-Element nicht angegeben wird, dann erscheint der Control-Element-Label-Attributtext auf dem Arbeitsaufgabenformular.
Link	Optionales Text-Element. Containerelement für den Link, der für ein Feld oder eine eigenständige Bezeichnung gilt, die im Arbeitsaufgabenformular angezeigt wird. Der Elementtyp ist HyperLinkType. Hinweis Geben Sie das Label-Attribut in einem Control-Element an, wenn Sie ein untergeordnetes Link-Element angeben. Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param.

Übergeordnete Elemente

Hinweise

Sie können einfachen und durch Links verbundenen Text kombinieren, indem Sie mehrere Text--Elemente in einem LabelText-Element hinzufügen.

Das LabelText-Element wird nur von Clients erkannt, die die neueste Version von Team Explorer ausführen. Daher muss das Label-Attribut in einem Control-Element angegeben werden. Bei Clients, die die aktuellste Version von Team Explorer ausführen, erscheint der Text, der von einem LabelText-Element bereitgestellt wurde, im Arbeitsaufgabenformular. Bei Clients, die frühere Versionen von Team Explorer ausführen, erscheint der Text, der vom Control-Element-Label-Attribut angegeben wurde, im Arbeitsaufgabenformular.

Beispiel: Eigenständige Bezeichnung

Beschreibungen

Im folgenden Beispiel wird einem Arbeitsaufgabenformular folgender Nur-Text hinzugefügt: "Geben Sie in folgendem Feld Details zur Reproduktion des Bugs ein:"

Code

<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>

Beispiel: Eigenständige Bezeichnung mit Link

Beschreibungen

Im folgenden Beispiel wird ein Link mit der Beschriftung "How do I use this work item?" einem Arbeitsaufgabenformular hinzugefügt.

Code

<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>

Beispiel: Ein Link wird auf Teile des Texts angewendet

Beschreibungen

Im folgenden Beispiel wird eine zweiteilige Bezeichnung einem Arbeitsaufgabenformular hinzugefügt. Der erste Teil, "Iterationspfad", ist einem Link zugeordnet. Der zweite Teil, "(muss eine Tiefe von drei Ebenen besitzen)", wird im Arbeitsaufgabenformular als Nur-Text angezeigt.

Code

<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>

Schemadefinitionen

Die Schemadateien zum Definieren von Arbeitsaufgabentypen stehen auf der folgenden Seite der Microsoft-Website zum Download bereit: Prozessvorlage- and Arbeitsaufgabenschemas für Visual Studio Team Foundation (möglicherweise in englischer Sprache). Weitere Informationen zum Verwenden der Schemadateien finden Sie auf der folgenden Seite der Microsoft-Website: Bearbeiten von Arbeitsaufgabentypen und Prozessvorlagen für Team Foundation in Visual Studio mithilfe der Schemas (möglicherweise in englischer Sprache).

Element: LabelText

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

Komplexer Typ: LabelElementType

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

Komplexer Typ: TextElementType

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

Siehe auch

Konzepte

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

Weitere Ressourcen

Elements (Work Item Type Definition Schema)

Änderungsprotokoll