Référence des éléments XML WebpageControlOptions

Vous pouvez afficher le contenu défini pour une page Web ou dans une balise CDATA sur un formulaire d'élément de travail à l'aide de l'élément WebpageControlOptions. Vous pouvez inclure les éléments enfants Link ou Content pour spécifier une URL ou HTML pour le contenu à afficher dans le formulaire.

L'élément WebpageControlOptions est un élément enfant de l'élément CONTROL.

Hiérarchie de schéma

WITD

   WORKITEMTYPE

       FORM

           Disposition

               Groupe

               Colonne

               TabGroup

                  Onglet

                     Contrôle

<xs:element name="WebpageControlOptions" type="WebpageControlOptionsType" minOccurs="0" maxOccurs="1" />
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Éléments enfants et attributs

Élément	Attribut	Description
WebpageControlOptions		Élément Control facultatif lorsque type="WebpageControl". Élément conteneur pour la définition d'une URL dont le contenu sera restitué dans le formulaire d'élément de travail. Élément LINK facultatif. Requis si UrlPath est spécifié. Spécifie une valeur à utiliser pour déterminer l'URL du lien hypertexte lorsque UrlPath est spécifié. L'élément est de type complexe : WebpageControlOptionsType.
	AllowScript	Attribut WebpageControlOptions facultatif. Spécifie si le code JavaScript de la page Web est autorisé à s'exécuter (true) ou non (false). Le type de l'attribut est xs:boolean. Tous les autres paramètres tels qu'ActiveX sont basés sur les paramètres Internet Explorer définis pour le client.
	ReloadOnParamChange	Attribut WebpageControlOptions facultatif. Spécifie si le contenu de la page Web doit être rechargé (true) lorsqu'un paramètre du formulaire d'élément de travail est modifié (true) ou non (false). Le type de l'attribut est xs:boolean. La valeur par défaut est true.
Link		Élément WebpageControlOptions facultatif. Cet élément et l'élément Content s'excluent mutuellement. Spécifie l'URL de la page Web à restituer dans le formulaire d'élément de travail. Pour plus d'informations, consultez Référence des éléments XML Link et Param.
Content		Élément WebpageControlOptions facultatif. Cet élément et l'élément Link s'excluent mutuellement. Spécifie le contenu HTML devant être restitué par le contrôle de page Web. Le contenu est spécifié dans une balise CDATA. Par exemple : <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Le type d'élément est xs:string. Remarque Le contenu HTML n'est pas validé avant sa restitution dans le formulaire d'élément de travail.

Éléments parents

Notes

Les éléments Link et Content s'excluent mutuellement.

Les attributs AllowScript et ReloadOnParamChange ne sont pas autorisés lorsque vous utilisez l'élément Content.

Lorsque le contrôle de page Web est configuré pour afficher le HTML brut, tout le script est désactivé. Tous les liens hypertexte dans le contenu cliqués sont ouverts dans le navigateur Web Visual Studio si le formulaire d'élément de travail est affiché dans Visual Studio ou dans Internet Explorer.

Plusieurs boutons de barre d'outils sont ajoutés au formulaire d'élément de travail d'un onglet qui contient WebpageControl. Ces options incluent les fonctions suivantes :

• Navigation vers l'arrière et l'avant

• Arrêt du chargement du contenu et actualisation du contenu

• Retourner à la page d'accueil du contenu

• Ouverture du contenu dans une nouvelle fenêtre ou dans un navigateur externe

De plus, si la page Web à charger contient le contenu non fiable, l'icône est bloquée et l'icône bloquée apparaît.

L'élément WebpageControlOptions est reconnu uniquement par les clients qui exécutent la version la plus récente de Team Explorer. Pour les versions antérieures, une zone rouge est affichée et un message apparaît indiquant que le contrôle n'a pas pu être trouvé. Pour plus d'informations, consultez Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail.

Exemple

L'exemple suivant montre comment charger un formulaire d'élément de travail avec du code HTML défini dans une balise CDATA.

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

Définitions de schéma

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>

Informations sur les éléments

Voir aussi

Concepts

Spécification des contrôles de formulaire d'élément de travail

Conception et personnalisation d'un formulaire d'élément de travail

Autres ressources

Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail

Historique des modifications