XML-Elementreferenz für WebpageControlOptions

Artikel
05/16/2015

Sie können für eine Webseite oder in einem CDATA-Tag für ein Arbeitsaufgabenformular definierten Inhalt mit dem WebpageControlOptions-Element anzeigen. Sie können entweder das untergeordnete Link-Element oder das untergeordnete Content-Element einschließen, um entweder eine URL oder HTML für den Inhalt anzugeben, der im Formular angezeigt wird.

Um Elemente einem Formular hinzuzufügen, ändern Sie einen Arbeitsaufgabentyp. Siehe Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).

Das WebpageControlOptions-Element ist ein untergeordnetes Element des CONTROL-Elements.

Schemahierarchie

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >    <Link UrlRoot="UrlRoot" UrlPath="UrlPathWithParameters">       <Param Index="IndexValue " Value="Param Value " Type="Original | Current" />    </Link>    <Content>       <![CDATA[Contents of HTML]]>    </Content> </WebpageControlOptions>

Attribute und Elemente

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

Untergeordnete Elemente und Attribute

Element	Attribut	Beschreibung
WebpageControlOptions		Optionales Control-Element, wenn type="WebpageControl". Containerelement zum Definieren einer URL, deren Inhalt im Arbeitsaufgabenformular gerendert wird. Optionales Link-Element. Erforderlich, wenn UrlPath angegeben ist. Gibt einen Wert an, mit dem die URL des Links bestimmt wird, wenn UrlPath angegeben ist. Der Elementtyp ist der komplexe Typ: WebpageControlOptionsType.
	AllowScript	Optionales WebpageControlOptions-Attribut. Gibt an, ob JavaScript innerhalb der Webseite (true) oder nicht (false) ausgeführt werden kann. Der Attributtyp ist xs:boolean. Alle anderen Einstellungen, z. B. ActiveX, basieren auf den für den Client definierten Internet Explorer-Einstellungen.
	ReloadOnParamChange	Optionales WebpageControlOptions-Attribut. Gibt an, ob (true) der Inhalt der Webseite erneut geladen werden soll, wenn ein Parameter im Arbeitsaufgabenformular (true) geändert wird, oder nicht (false). Der Attributtyp ist xs:boolean. Der Standardwert ist true.
Link		Optionales WebpageControlOptions-Element. Dieses Element und das Content-Element schließen sich gegenseitig aus. Gibt die URL für die Webseite an, die im Arbeitsaufgabenformular gerendert werden soll. Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param.
Content		Optionales WebpageControlOptions-Element. Dieses Element schließt sich gegenseitig mit dem Link-Element aus. Gibt den HTML-Inhalt an, der vom Webseiten-Steuerelement gerendert werden soll. Der Inhalt wird innerhalb eines CDATA-Tags angegeben. Beispiel: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Der Elementtyp ist xs:string. Hinweis Der HTML-Inhalt wird nicht vor dem Rendern im Arbeitsaufgabenformular überprüft.

Übergeordnete Elemente

Element	Beschreibung
Steuerelement	Erforderliches übergeordnetes Element Definiert ein Feld, Text, einen Link oder ein anderes Steuerelement, das auf dem Arbeitsaufgabenformular angezeigt wird.
Text	Optionales LabelText-Element. Containerelement für die Informationen oder die Bezeichnung, die im Arbeitsaufgabenformular angezeigt werden. Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text.

Steuerelement

Erforderliches übergeordnetes Element Definiert ein Feld, Text, einen Link oder ein anderes Steuerelement, das auf dem Arbeitsaufgabenformular angezeigt wird.

Text

Optionales LabelText-Element.

Containerelement für die Informationen oder die Bezeichnung, die im Arbeitsaufgabenformular angezeigt werden.

Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text.

Hinweise

Die Link- und Content-Elemente schließen sich gegenseitig aus.

Die AllowScript- und ReloadOnParamChange-Attribute sind nicht erlaubt, wenn Sie das Content-Element verwenden.

Wenn das Webseiten-Steuerelement dafür konfiguriert wird, unformatiertes HTML anzuzeigen, wird die gesamte Skripterstellung deaktiviert. Alle Links im Inhalt, auf die geklickt werden, sind im Visual Studio-Webbrowser geöffnet, wenn das Arbeitsaufgabenformular in Visual Studio oder in Internet Explorer angezeigt wird.

Mehrere Symbolleistenschaltflächen werden dem Arbeitsaufgabenformular für eine Registerkarte hinzugefügt, die WebpageControl enthält. Diese Optionen umfassen die folgenden Funktionen:

Rückwärts- und Vorwärtsnavigation
Laden von Inhalt und Aktualisieren von Inhalt anhalten
Zur Inhalts-Homepage zurückkehren
Den Inhalt in einem neuen Fenster oder in einem externen Browser öffnen

Außerdem, wenn die Webseite, die geladen werden soll, nicht vertrauenswürdigen Inhalt enthält, wird das Symbol blockiert, und das Symbol für die Blockierung wird angezeigt.

Das WebpageControlOptions-Element wird nur von Clients erkannt, die die neueste Version von Team Explorer ausführen. Bei früheren Versionen werden ein roter Bereich und eine Meldung angezeigt, die angibt, dass das Steuerelement nicht gefunden werden konnte. Weitere Informationen finden Sie unter Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular.

Beispiel

Im folgenden Beispiel wird gezeigt, wie ein Arbeitsaufgabenformular mit einem in CDATA-Tag definiertem HTML geladen wird.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
         <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
      </Content>
   </WebpageControlOptions>
</Control>

Schemadefinitionen

WebpageControlOptionsType

<xs:complexType name="WebpageControlOptionsType">
   <xs:choice minOccurs="1" maxOccurs="1">
      <xs:element name="Link" type="HyperLinkType"/>
      <xs:element name="Content" type="xs:string"/>
   </xs:choice>
      <xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
      <xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

Elementinformationen

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

Siehe auch

Konzepte

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Entwerfen des Arbeitsaufgabenformulars

Weitere Ressourcen

Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular

Freigeben über