Riferimento agli elementi XML WebpageControlOptions
È 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. Il tipo di elemento è 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 |
|---|---|
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. |
|
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