Condividi tramite


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.

L'elemento WebpageControlOptions è un elemento figlio di CONTROL.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppo

               Column

               TabGroup

                  Tab

                     Controllo

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Elementi figli e attributi

Elemento

Attribute

Oggetto di 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 utilizzare 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ò eseguire (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 ulteriori 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. Di seguito è riportato un esempio.

<![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]>

Il tipo di elemento è xs:string.

NotaNota
Il contenuto HTML non viene convalidato prima dell'esecuzione del rendering nel form elemento di lavoro.

Elementi padre

Elemento

Oggetto di 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 ulteriori 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 utilizza 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 rossa e un messaggio viene visualizzato indicando che il controllo non è stato trovato. Per ulteriori informazioni, vedere Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

Esempio

Nell'esempio seguente viene mostrato 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

Specifica dei controlli dei form elemento di lavoro

Progettazione e personalizzazione di un form elemento di lavoro

Altre risorse

Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro

Cronologia delle modifiche

Data

Cronologia

Motivo

Maggio 2011

Sono state corrette le maiuscole/minuscole di diversi elementi e attributi della sintassi XML. La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole camel e porta in maiuscolo tutte le lettere nei nomi degli altri elementi.

Correzione di bug nel contenuto.

Gennaio 2011

Rimosso collegamenti a argomenti rimossi.

Miglioramento delle informazioni.