Riferimento agli elementi XML WebpageControlOptions

Articolo
11/18/2015

È possibile visualizzare il contenuto definito per una pagina Web o all'interno di un tag CDATA su un form elemento di lavoro tramite l'elemento WebpageControlOptions. È possibile includere Link o gli elementi figlio Content per specificare un URL o un HTML affinché il contenuto appaia nel form.

Per aggiungere elementi a un form, modificare un tipo di elemento di lavoro. Vedere Modificare o aggiungere un tipo di elemento di lavoro personalizzato (WIT).

L'elemento WebpageControlOptions è un elemento figlio dell'elemento CONTROL.

Gerarchia dello schema

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Elementi figli e attributi

Elemento	Attributo	Descrizione
WebpageControlOptions		Elemento Control facoltativo quando type="WebpageControl". Elemento del contenitore per la definizione di un URL il cui contenuto verrà sottoposto a rendering nel form elemento di lavoro. Elemento Link facoltativo. Obbligatorio quando UrlPath è specificato. Specifica un valore da usare per determinare l'URL del collegamento ipertestuale quando UrlPath viene specificato. L'elemento è di tipo complesso: WebpageControlOptionsType.
	AllowScript	Attributo WebpageControlOptions facoltativo. Specifica se JavaScript all'interno della pagina Web può essere eseguito (true) o meno (false). Il tipo dell'attributo è xs:boolean. Tutte le altre impostazioni quale ActiveX si basano sulle impostazioni Internet Explorer definite per il client.
	ReloadOnParamChange	Attributo WebpageControlOptions facoltativo. Specifica se ricaricare (true) il contenuto della pagina Web quando viene modificato un parametro nel form elemento di lavoro (true) o meno (false). Il tipo dell'attributo è xs:boolean. Il valore predefinito è true.
Link		Elemento WebpageControlOptions facoltativo. Questo elemento e l'elemento Content si escludono a vicenda. Specifica l'URL per la pagina Web da sottoporre a rendering nel form elemento di lavoro. Per altre informazioni, vedere Riferimento agli elementi XML Link e Param.
Content		Elemento WebpageControlOptions facoltativo. Questo elemento e l'elemento Link si escludono a vicenda. Specifica il contenuto HTML il cui rendering deve essere eseguito dal controllo pagina Web. Il contenuto viene specificato all'interno di un tag CDATA. Ad esempio: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> Il tipo di elemento è xs:string. Nota Il contenuto HTML non viene convalidato prima dell'esecuzione del rendering nel form elemento di lavoro.

Elementi padre

Elemento	Descrizione
Controllo	Elemento padre obbligatorio. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.
Testo	Elemento LabelText facoltativo. Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro. Per altre informazioni, vedere Riferimento agli elementi XML LabelText e Text.

Controllo

Elemento padre obbligatorio. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.

Testo

Elemento LabelText facoltativo.

Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro.

Per altre informazioni, vedere Riferimento agli elementi XML LabelText e Text.

Note

Gli elementi Link e Content si escludono reciprocamente.

Gli attributi AllowScript e ReloadOnParamChange non sono consentiti quando si usa l'elemento Content.

Quando il controllo della pagina Web è configurato per visualizzare HTML non elaborato, lo scripting viene disabilitato. Qualsiasi collegamento ipertestuale nel contenuto su cui si fa clic viene aperto nel browser Web di Visual Studio se il form elemento di lavoro viene mostrato in Visual Studio o in Internet Explorer.

Diversi pulsanti della barra degli strumenti vengono aggiunti al form elemento di lavoro per una scheda che contiene WebpageControl. Queste opzioni includono le seguenti funzioni:

Navigazione indietro e in avanti
Interrompere il caricamento del contenuto e aggiornare il contenuto
Ritorna alla home page del contenuto
Aprire il contenuto in una nuova finestra o in un browser esterno

Inoltre, se la pagina Web da caricare contiene contenuto non attendibile, l'icona è bloccata e viene visualizzata.

L'elemento WebpageControlOptions viene riconosciuto solo dai client che eseguono la versione più recente di Team Explorer. Per le versioni precedenti, viene visualizzata un'area di colore rosso e viene visualizzato un messaggio che indica che il controllo non è stato trovato. Per altre informazioni, vedere Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su un form elemento di lavoro.

Esempio

L'esempio seguente illustra come caricare un form elemento di lavoro con HTML definito in un tag 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>

Definizioni dello schema

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>

Informazioni sull'elemento

Spazio dei nomi	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome di schema	Definizione del tipo di elemento di lavoro
File di convalida	WorkItemTypeDefinition.xsd
Tipo di elemento	WebpageControlOptionsType
Può essere vuoto	Non applicabile

Vedere anche

Concetti

Specificare i controlli dei form elemento di lavoro

Progettare il form elemento di lavoro

Altre risorse

Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su un form elemento di lavoro

Condividi tramite