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
<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.
.gif "Dd936135.collapse_all(es-es,VS.110).gif")
Atributos 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. .gif "Nota") Nota
El contenido HTML no se valida antes de representarlo en el formulario de elemento de trabajo.
|
Elementos primarios
Elemento |
Descripción |
|---|---|
Elemento primario necesario.Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo. |
|
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
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>
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