Referência de elementos XML de WebpageControlOptions

Artigo
08/01/2011

Você pode exibir o conteúdo definido para uma página da Web ou dentro de uma tag CDATA em um formulário de item de trabalho usando o WebpageControlOptions elemento. Você pode incluir tanto o LINK ou CONTENT elementos filho para especificar um URL ou o HTML para o conteúdo apareça no formulário.

Um elemento WebpageControlOptions é um filho do elemento CONTROL.

Hierarquia de esquema

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

Atributos e elementos

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

Atributos e elementos filho

Elemento	Atributo	Descrição
WebpageControlOptions		Opcional Control elemento ao type="WebpageControl". Elemento de contêiner para definir uma URL, cujo conteúdo será processado no formulário de item de trabalho. Opcional LINK elemento. Necessário ao URLPath é especificado. Especifica um valor a ser usado para determinar a URL do hiperlink quando URLPath é especificado. O tipo de elemento é um tipo complexo: WebpageControlOptionsType.
	AllowScript	Opcional WebpageControlOptions atributo. Especifica se o JavaScript na página da Web é permitido executar (true) ou não (false). O tipo de atributo é xs:boolean. Todas as outras configurações, como, por exemplo, ActiveX baseiam-se as configurações do Internet Explorer definidas para o cliente.
	ReloadOnParamChange	Opcional WebpageControlOptions atributo. Especifica se recarregar (true) 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 de atributo é xs:boolean. O valor padrão é true.
Link		Opcional WebpageControlOptions elemento. Este elemento é mutuamente exclusivo com o Content elemento. Especifica a URL da página da Web a ser processado no formulário de item de trabalho. Para obter mais informações, consulte Link e referência de elementos XML de Param.
Content		Opcional WebpageControlOptions elemento. Este elemento é mutuamente exclusivo com o Link elemento. Especifica o conteúdo HTML a ser processado pelo controle de página da Web. O conteúdo é especificado dentro de uma tag 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 O conteúdo HTML não é validado antes para processamento de formulário de item de trabalho.

Elementos pai

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

Controle

Elemento pai obrigatório. Define um campo, o texto, o hiperlink ou outro elemento de controle seja exibido no formulário de item de trabalho.

Texto

Opcional LabelText elemento.

Elemento de contêiner para as informações ou o rótulo apareça no formulário de item de trabalho.

Para obter mais informações, consulte Referência de elementos XML LabelText e texto.

Comentários

O Link e Content elementos são mutuamente exclusivas.

O AllowScript e ReloadOnParamChange atributos não são permitidos ao usar o Content elemento.

Quando o controle de página da Web está configurado para exibir HTML bruto, todo o script está desativado. Todos os hiperlinks no conteúdo que são clicados são abertos no navegador da Web de Visual Studio se o formulário de item de trabalho é mostrado na 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 uma guia que contém WebpageControl. Essas opções incluem as seguintes funções:

Navegação voltar e Avançar
Parar o conteúdo de carregamento e atualizar conteúdo
Retornar à home page do conteúdo
Abrir o conteúdo em uma nova janela ou em um navegador externo

Além disso, se a página da Web a ser carregado contiver conteúdo não confiável, em seguida, o ícone é bloqueado e o ícone bloqueado aparece.

O WebpageControlOptions elemento só é reconhecido por clientes que estão executando a versão mais recente do Team Explorer. Para versões anteriores, uma área vermelha é exibida e aparece uma mensagem indicando que o controle não pôde ser encontrado. Para obter mais informações, consulte Fornecendo o texto de Ajuda, orientação do 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, definido em uma 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>

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

Namespace	https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/TypeDef
Nome de esquema	Definição de tipo de Item de trabalho
Arquivo de validação	WorkItemTypeDefinition.xsd
Tipo de elemento	WebpageControlOptionsType
Pode ficar vazio	Não aplicável.

Consulte também

Conceitos

Especificando os controles de formulário de Item de trabalho

Criando e personalizando um formulário de Item de trabalho

Outros recursos

Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho

Histórico de alterações

Date	History	Motivo
Janeiro de 2011	Removidos os links para tópicos que foram removidos.	Aprimoramento de informações.

Janeiro de 2011

Removidos os links para tópicos que foram removidos.

Aprimoramento de informações.

Compartilhar via