Steuern des XML-Elementverweises

Artikel
05/16/2015

Mit dem Control-Element werden ein Text, ein Link, ein Arbeitsaufgabenfeld oder ein anderes Steuerelement definiert, der bzw. das in einem Arbeitsaufgabenformular angezeigt werden soll. Beispiele für die Verwendung dieses Elements finden Sie unter Angeben von Steuerelementen für Arbeitsaufgabenformulare und Entwerfen des Arbeitsaufgabenformulars.

Schemahierarchie

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Padding="(top, bottom, left, right)" 
Margin="(top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
FieldName	Optionales Control-Attribut. Gibt das Arbeitsaufgabenfeld an, dem das Steuerelement zugeordnet wird. Der Attributtyp ist typelib:ReferenceFieldName. Mindestlänge: 1; maximale Länge: 70. Musterwert: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Musterwertbeispiel: Company.Division.IssueType
Type	Erforderliches Control-Attribut. Gibt den Datentyp des Steuerelements an. Der Attributtyp ist ValidControlsType (einfacher Typ). Geben Sie eine Zeichenfolge von einem der folgenden integrierten Typen an: AttachmentControl: Verwenden Sie diesen Typ, um Arbeitsaufgabenanlagen anzuzeigen. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp. DateTimeControl: Verwenden Sie diesen Typ, um die formatierten Datenfelder mit dem Feldtyp DateTime anzuzeigen. FieldControl: Verwenden Sie diesen Typ, um Nur-Text- oder numerische Felder und Listen mit Werten für Felder mit dem Feldtyp String, Identity, Integer, Double und PlainText anzuzeigen. HtmlFieldControl: Verwenden Sie diesen Typ, um mehrzeiliges Rich-Text-Format von Feldern mit dem Feldtyp HTML anzuzeigen. LabelControl: Verwenden Sie diesen Typ, um Text anzuzeigen, der keinem Feld zugeordnet ist. Der Text kann das Nur-Text- oder Linkformat besitzen. Sie können zusätzliche Steuerelemente mit den Elementen LabelText, Link und Text angeben. Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text und XML-Elementreferenz für Link und Param. LinksControl: Verwenden Sie diesen Typ, um die Symbolleiste für Linksteuerelemente anzuzeigen und Linkbeziehungen zwischen Arbeitsaufgaben und Storyboards zu verwalten. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp. Mit dem Element LinksControlOptions geben Sie die zu filternden Linktypen und andere Steuerelementoptionen an. Siehe LinksControlOptions-Elemente. WebpageControl: Verwenden Sie diesen Typ, um HTML-basierten Inhalt anzuzeigen, der von einem URI definiert wird oder in einen CDATA-Tag eingebettet ist. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp. . Sie geben den Inhalt und die Links an, die mithilfe des WebpageControlOptions-Elements angezeigt werden. Siehe XML-Elementreferenz für WebpageControlOptions. WorkItemClassificationControl: Verwenden Sie diesen Typ, um die hierarchischen Pfadfelder mit dem Feldtyp TreePath anzuzeigen. Hinweis Das System.AreaPath-Feld und das System.IterationPath-Feld sind die einzigen Felder, die diesen Datentyp verwenden.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren. WorkItemLogControl: Verwenden Sie diesen Typ, um Informationen zum Arbeitsaufgabenverlauf und Felder mit dem Feldtyp History anzuzeigen. Hinweis Das System.History-Feld ist das einzige Feld, das diesen Datentyp verwendet.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren. Weitere Informationen finden Sie unter Angeben von Steuerelementen für Arbeitsaufgabenformulare. Hinweis Sie können ein benutzerdefiniertes Steuerelement verwenden, indem Sie das Type-Attribut auf einen benutzerdefinierten Wert festlegen.Steuerelemente, deren Type-Wert nicht dem Namen eines integrierten Typs entspricht, werden wie benutzerdefinierte Steuerelemente behandelt.Weitere Informationen finden Sie auf der Microsoft-Website: Benutzerdefinierte Steuerelemente zum Nachverfolgen von Arbeitsaufgaben.
ControlFontSize	Optionales Control-Attribut. Gibt den Schriftgrad des Feldnamens oder der Bezeichnung auf dem Formular an. Gültige Werte von FontSize: small, normal, large, xlarge und xxlarge.
EmptyText	Optionales Control-Attribut. Gibt eine Textzeichenfolge mit einer Länge zwischen 1 und 255 Buchstaben an, die angezeigt wird, wenn ein Feld leer ist.
Label	Optionales Control-Attribut. Gibt den sichtbaren Text auf dem Formular an, mit dem das Steuerelement identifiziert wird. Geben Sie eine Zeichenfolge mit höchstens 80 Zeichen an.
LabelFontSize	Gibt den Schriftgrad der Bezeichnung auf dem Formular an. Gültige Werte für FontSize: small, normal, large, xlarge und xxlarge.
LabelPosition	Optionales Control-Attribut. Gibt die Position der Bezeichnung relativ zu den Steuerelementdaten an. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: Top: Platziert die Bezeichnung über den Steuerelementdaten. Bottom: Platziert die Bezeichnung unter den Steuerelementdaten. Left: Platziert die Bezeichnung links von den Steuerelementdaten. Right: Platziert die Bezeichnung rechts von den Steuerelementdaten.
Padding	Optionales Control-Attribut. Gibt den Raum in Pixel um den inneren Rahmen des Steuerelements an, der den Räumen oben, unten, links und rechts entspricht. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+\,\d+\,\d+$$ Musterwertbeispiel: (2,0,2,0)
Margin	Optionales Control-Attribut. Gibt den Raum in Pixel um den äußeren Rahmen des Steuerelements an, der den Räumen oben, unten, links und rechts entspricht. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+\,\d+\,\d+$$ Musterwertbeispiel: (2,0,2,0)
ReadOnly	Optionales Control-Attribut. Gibt an, dass das Feld schreibgeschützt ist. Der Attributtyp ist ReadOnlyType. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: True: Gibt an, dass die Steuerelementdaten schreibgeschützt sind. False: Gibt an, dass die Steuerelementdaten nicht schreibgeschützt sind.
MinimumSize	Optionales Control-Attribut. Gibt die minimale Größe in Pixel an, die das Steuerelement im Formular einnehmen sollte. Die Syntax wird in (width,height) angegeben. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+$$ Musterwertbeispiel: (100,100) Hinweis Wenn in vertikaler Richtung nicht genügend Platz vorhanden ist, wird eine Bildlaufleiste angezeigt, um die Mindestgröße beizubehalten.Ohne dieses Attribut werden die Steuerelemente mit ihren Standardgrößen gezeichnet, außer wenn Steuerelemente in anderen Registerkarten mehr Platz benötigen.Die Gesamtgröße eines beliebigen einzelnen Formularsteuerelements hängt von der Größe des größten Formularbereichs bzw. der größten Registerkarte ab.
Name	Optionales Control-Attribut. Identifiziert ein Steuerelement auf eindeutige Weise. Der Name ist wichtig, wenn einem Arbeitsaufgabenfeld mehr als ein Steuerelement eines Formulars zugeordnet ist. Der Attributtyp ist xs:string. Hinweis Sie verwenden das Name-Attribut, wenn Sie das gleiche Feld an mehr als einer Position im Formular anzeigen lassen möchten.Geben Sie für beide Steuerelementeinträge einen eindeutigen Wert für das Name-Attribut an, damit das System jedes Steuerelement eindeutig identifiziert.Es ist nützlich, dasselbe Steuerelement basierend auf dem Kontext der Registerkarten an verschiedenen Positionen anzuzeigen.
NumberFormat	Optionales Control-Attribut, das nur gültig ist, wenn es mit FieldControl verwendet wird. Gibt die Zeichen an, die Sie im Feldsteuerelement eingeben können. Gültige Werte, die Sie verwenden können: WholeNumbers: Gibt an, dass Ganzzahlen zugelassen werden. SignedWholeNumbers: Gibt an, dass signierte Ganzzahlen zugelassen werden. DecimalNumbers: Gibt an, dass Dezimalzahlen zugelassen werden. SignedDecimalNumbers: Gibt an, dass signierte Dezimalzahlen zugelassen werden.
MaxLength	Optionales Control-Attribut, das nur gültig ist, wenn es mit FieldControl verwendet wird. Gibt die maximale Länge zulässiger Zeichen für ein Feldsteuerelement an. Der Attributtyp ist xs:integer.
Format	Optionales Control-Attribut, das nur gültig ist, wenn es mit DateTimeControl verwendet wird. Gibt das Format für das Datums-/Uhrzeitfeld an, das einem der Werte der DateTimePickerFormat-Enumeration entspricht. Gültige Werte, die Sie verwenden können: Custom: Zeigt den Wert von Datum und Uhrzeit in einem benutzerdefinierten Format an. Das benutzerdefinierte Format kann durch Angeben von "Benutzerdefiniert" als Wert für das Formatattribut und Festlegen eines anderen Attributs mit dem Namen "CustomFormat" mit einer benutzerdefinierten Formatzeichenfolge festgelegt werden. Beispiel: Format="Custom" CustomFormat = "MMM tt, 'des Jahres' jjjj" Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePicker.CustomFormat-Eigenschaft. Long: Zeigt den Wert von Datum und Uhrzeit im langen Datumsformat an, das durch das Betriebssystem des Benutzers festgelegt ist. Short: Zeigt den Wert von Datum und Uhrzeit im kurzen Datumsformat an, das durch das Betriebssystem des Benutzers festgelegt ist. Time: Zeigt den Wert von Datum und Uhrzeit in dem Zeitformat an, das durch das Betriebssystem des Benutzers festgelegt ist. Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePickerFormat-Enumeration.
CustomFormat	Optionales Control-Attribut, das nur gültig ist, wenn es mit DateTimeControl und dem Format-Attribut verwendet wird. Gibt das benutzerdefinierte Format für das Datums-/Uhrzeitfeld an, das der für die DateTimePicker.CustomFormat-Eigenschaft definierten Syntax entspricht. Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePicker.CustomFormat-Eigenschaft.

Untergeordnete Elemente

Element	Beschreibung
LabelText	Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als FieldControl oder LabelControl angegeben wird. Containerelement zum Angeben von Text, Link und Position von einem Feld oder einer Bezeichnung, deren Text teilweise einem Link zugeordnet ist. Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text und Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular.
Link	Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als FieldControl oder LabelControl angegeben wird. Definiert den Link für ein Feld oder eine Bezeichnung. Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param und Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular.
LinksControlOptions	Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als LinksControl angegeben wird. Definiert die Linkfilter und das Layout von Spaltenfeldern, um die Liste der Links anzuzeigen. Weitere Informationen finden Sie unter Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen.
WebpageControlOptions	Optionales Element. Sie können dieses Element festlegen, wenn das Type-Attribut WebpageControl ist. Gibt die Steuerelemente an, die das Laden des Webseitenziels im Arbeitsaufgabenformular steuern. Weitere Informationen finden Sie unter XML-Elementreferenz für WebpageControlOptions und Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular.
anyAttribute	Optionales Element. Dies ist optional. Control ist durch die Verwendung des anyAttribute-Elements erweiterbar.

Übergeordnete Elemente

Element	Beschreibung
Layout	Erforderlich. Definiert, wie die Elemente auf dem Arbeitsaufgabenformular angezeigt werden.
Column-Element	Erforderlich. Definiert Spalten für das Formular.
Tab-Element	Erforderlich. Definiert eine Registerkarte für das Formular.

Hinweise

Control ist ein optionales untergeordnetes Element von Layout, Column und Tab.

Layout- und Column-Indikatoren:

minOccurs = "0"

maxOccurs = "1"

Tab-Indikatoren:

minOccurs = "0"

maxOccurs = "unbounded"

Um ein benutzerdefiniertes Steuerelement zu implementieren, muss der Name des Steuerelements für das Type-Attribut angegeben werden. Weitere Informationen finden Sie auf der Microsoft-Website: Benutzerdefinierte Steuerelemente zum Nachverfolgen von Arbeitsaufgaben.

Ein Beispiel für jeden Steuerelementtyp finden Sie unter Angeben von Steuerelementen für Arbeitsaufgabenformulare.

Beispiel

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" Padding="(2,0,2,0)" Margin="(2,2,2,2)" />

Elementinformationen

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Schemaname	Definition des Arbeitsaufgabentyps
Validierungsdatei	WorkItemTypeDefinition.xsd
Elementtyp	Komplexer ControlType-Typ
Kann leer sein	Nicht zutreffend