Compartir a través de


WebpageControlOptions (Referencia de elementos de XML)

Puede mostrar contenido definido para una página web o dentro de una etiqueta de CDATA en un formulario de elemento de trabajo utilizando el elemento WebpageControlOptions.Puede incluir Link o los elementos secundarios Content para especificar una dirección URL o HTML para que el contenido aparezca en el formulario.

El elemento WebpageControlOptions es un elemento secundario del elemento CONTROL.

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Agrupar

               Columna

               TabGroup

                  Tab

                     Control

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Dd936135.collapse_all(es-es,VS.110).gifAtributos y elementos secundarios

Elemento

Atributo

Descripción

WebpageControlOptions

Elemento Control opcional cuando type="WebpageControl".

Elemento contenedor para definir una dirección URL cuyo contenido se representará en el formulario de elemento de trabajo.

Elemento Link opcional.Es obligatorio si se especifica UrlPath.

Especifica un valor que se va a usar para determinar la dirección URL del hipervínculo cuando se especifica UrlPath.

El tipo de elemento es el tipo complejo: WebpageControlOptionsType.

AllowScript

Atributo WebpageControlOptions opcional.

Especifica si JavaScript dentro de la página web se puede ejecutar (true) o no (false).El tipo de atributo es xs:boolean.

Todos los demás valores como ActiveX se basan en los valores de Internet Explorer definidos para el cliente.

ReloadOnParamChange

Atributo WebpageControlOptions opcional.

Especifica si se recarga el contenido de la página web(true) cuando se cambia un parámetro del formulario de elemento de trabajo (true) o no (false).El tipo de atributo es xs:boolean.

El valor predeterminado es true.

Link

Elemento WebpageControlOptions opcional.Este elemento es mutuamente excluyente respecto al elemento Content.

Especifica la dirección URL de la página web que se va a representar en el formulario de elemento de trabajo.

Para obtener más información, vea Referencia de los elementos Link y Param de XML.

Content

Elemento WebpageControlOptions opcional.

Este elemento es mutuamente excluyente respecto al elemento Link.

Especifica el contenido HTML que será representado por el control de página web.El contenido se especifica dentro de una etiqueta de CDATA.Por ejemplo:

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

El tipo de elemento es xs:string.

NotaNota
El contenido HTML no se valida antes de representarlo en el formulario de elemento de trabajo.

Dd936135.collapse_all(es-es,VS.110).gifElementos primarios

Elemento

Descripción

Control

Elemento primario necesario.Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo.

Texto

Elemento LabelText opcional.

Elemento contenedor para la información o etiqueta que aparecerá en el formulario de elemento de trabajo.

Para obtener más información, vea Referencia de los elementos LabelText y Text de XML.

Comentarios

Los elementos Link y Content son mutuamente excluyentes.

No se permiten los atributos ReloadOnParamChange y AllowScript al utilizar el elemento Content.

Cuando el control de página web se configura para mostrar HTML sin formato, todo el script se deshabilita.Cualquier hipervínculo del contenido en el que se haga clic, se abre en el explorador web de Visual Studio si el formulario de elementos de trabajo se muestra en Visual Studio o en Internet Explorer.

Varios botones de la barra de herramientas se agregan al formulario de elemento de trabajo de una pestaña que contiene WebpageControl.Estas opciones incluyen las funciones siguientes:

  • Navegación hacia delante y hacia atrás

  • Detener la carga de contenido y actualizarlo

  • Volver a la página principal de contenido

  • Abra el contenido en una nueva ventana o en un explorador externo

Además, si la página web que se va a cargar contiene contenido que no es de confianza, se bloquea el icono y aparece el icono bloqueado.

Solo los clientes que están ejecutando la última versión de Team Explorer reconocen el elemento WebpageControlOptions.Para las versiones anteriores, se muestra un área roja y aparece un mensaje indicando que no se pudo encontrar el control.Para obtener más información, vea Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos a páginas web en un formulario de elemento de trabajo.

Ejemplo

En el ejemplo siguiente se muestra cómo cargar un formulario de elemento de trabajo con HTML definido en una etiqueta de 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>

Definiciones de esquema

Dd936135.collapse_all(es-es,VS.110).gifWebpageControlOptionsType

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

Dd936135.collapse_all(es-es,VS.110).gifNonBlankString

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

Información del elemento

Espacio de nombres

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nombre de esquema

Definición del tipo de elemento de trabajo

Archivo de validación

WorkItemTypeDefinition.xsd

Tipo de elemento

WebpageControlOptionsType

Puede estar vacío

No es aplicable

Vea también

Conceptos

Especificar controles de formulario de elemento de trabajo

Diseñar y personalizar un formulario de elementos de trabajo

Otros recursos

Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos a páginas web en un formulario de elemento de trabajo