Referência de elementos XML WebpageControlOptions

Você pode exibir o conteúdo definido para uma página da Web ou dentro de uma marca CDATA em um formulário de item de trabalho usando o elemento de WebpageControlOptions .Você pode incluir Link ou elementos filhos de Content para especificar um URL ou HTML para que o conteúdo exibido no formulário.

Um elemento WebpageControlOptions é um filho do elemento CONTROL.

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

               Group

               Coluna

               TabGroup

                  Tab

                     Controle

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

As seções a seguir descrevem elementos filho, atributos, e elementos pai.

Elementos filhos e atributos

Elemento	Atributo	Descrição
WebpageControlOptions		Elemento opcional de Control quando type="WebpageControl". Recipiente para definir um URL cujos conteúdos são processados no formulário de item de trabalho. Elemento de Link opcional.Necessário UrlPath quando é especificado. Especifica um valor a ser usado para determinar o URL de hiperlink UrlPath quando é especificado. O tipo de elemento é tipo complexo: WebpageControlOptionsType.
	AllowScript	Atributo opcional de WebpageControlOptions . Especifica se o Javascript na página da Web é permitido executar (true) ou não (false).O tipo do atributo é xs:boolean. Todas configurações restantes como ActiveX são baseados nas configurações do Internet Explorer definidas para o cliente.
	ReloadOnParamChange	Atributo opcional de WebpageControlOptions . Especifica setrue) (recarregar o conteúdo da página da Web quando um parâmetro no formulário de item de trabalho é alterado (true) ou não (false).O tipo do atributo é xs:boolean. O valor padrão é true.
Link		Elemento de WebpageControlOptions opcional.Esse elemento é mutuamente exclusiva com o elemento de Content . Especifica a URL para a página da Web é processada no formulário de item de trabalho. Para obter mais informações, consulte Referência de elementos XML link e Param.
Content		Elemento de WebpageControlOptions opcional. Esse elemento é mutuamente exclusiva com o elemento de Link . Especifica o conteúdo HTML que deve ser processado pelo controle da página da Web.O conteúdo é especificado em uma marca CDATA.Por exemplo: <![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]> O tipo de elemento é xs:string. Observação Conteúdo HTML não é validado antes renderizá-las no formulário de item de trabalho.

Elementos pai

Elemento	Descrição
Controle	Elemento pai necessário.Define um campo, texto, o hiperlink, ou outro elemento de controle seja exibido no formulário de item de trabalho.
Texto	Elemento de LabelText opcional. Elemento contêiner para que informações ou o rótulo aparece no formulário de item de trabalho. Para obter mais informações, consulte Referência de elementos XML LabelText e texto.

Comentários

Os elementos de Link e de Content são mutuamente exclusivos.

Atributos de AllowScript e de ReloadOnParamChange não são permitidos quando você usa o elemento de Content .

Quando o controle da página da Web é configurado para exibir HTML bruto, qualquer script está desativado.Todos os hiperlinks no conteúdo que são clicados estão abertos no navegador da Web do Visual Studio se o formulário de item de trabalho é mostrado em Visual Studio ou no Internet Explorer.

Vários botões da barra de ferramentas são adicionados ao formulário de item de trabalho para um guia que contém WebpageControl.Essas opções incluem as seguintes funções:

• Navegação de volta e frente

• Carga de conteúdo de interrupção e atualizar conteúdo

• Retorno para a página de conteúdo

• Abra o conteúdo em uma nova janela ou em um navegador externo

Além disso, se a página da Web a ser carregada contém o conteúdo não confiável, o ícone é bloqueado e o ícone com barreira aparece.

O elemento de WebpageControlOptions é reconhecido apenas pelos clientes que estão executando a versão mais recente de Team Explorer.Para versões anteriores, uma área vermelha é exibida e uma mensagem aparecerá indicando que o controle não pôde ser encontrado.Para obter mais informações, consulte Fornecer texto da Ajuda, diretrizes de processo, conteúdo da Web e links para páginas da Web em um formulário de item de trabalho.

Exemplo

O exemplo a seguir mostra como carregar um formulário de item de trabalho com HTML definiu em uma marca 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>

Definições 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>

Informações de elemento

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome de esquema	Definição de tipo de item de trabalho
Validação Arquivo	WorkItemTypeDefinition.xsd
Tipo de elemento	WebpageControlOptionsType
Pode ser deixado	Não aplicável.

Consulte também

Conceitos

Especificar controles de formulário de item de trabalho

Criar e personalizar um formulário de item de trabalho

Outros recursos

Fornecer texto da Ajuda, diretrizes de processo, conteúdo da Web e links para páginas da Web em um formulário de item de trabalho