Referência de elementos XML WebpageControlOptions
Você pode exibir conteúdo definido para uma página da Web ou em uma marca CDATA em um formulário de item de trabalho usando o WebpageControlOptions elemento. Você pode incluir a Link ou o Content elementos filho para especificar um URL ou HTML para o conteúdo seja exibido no formulário.
Para adicionar elementos a um formulário, você deve modificar um tipo de item de trabalho. Consulte Modificar ou adicionar um WIT (tipo de item de trabalho) personalizado.
O WebpageControlOptions é um elemento filho do CONTROL elemento.
Hierarquia de 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 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 quando type="WebpageControl". Elemento de contêiner para definir uma URL cujo conteúdo será renderizado no formulário de item de trabalho. Opcional Link elemento. Necessário quando UrlPath for especificado. Especifica um valor a ser usado para determinar a URL do hiperlink quando UrlPath for especificado. O tipo de elemento é o tipo complexo: WebpageControlOptionsType. |
|
AllowScript |
Atributo WebpageControlOptions opcional. Especifica se é permitido executar JavaScript na página da Web (true) ou não (false). O tipo de atributo é xs:boolean. Todas as outras configurações, como ActiveX baseiam-se nas configurações do Internet Explorer definidas para o cliente. |
|
ReloadOnParamChange |
Atributo WebpageControlOptions opcional. Especifica se deseja 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. Esse elemento é mutuamente exclusivo com o Content elemento. Especifica a URL da página da Web a ser renderizado no formulário de item de trabalho. Para obter mais informações, consulte Referência de elementos XML para link e parâmetro. |
Content |
|
Opcional WebpageControlOptions elemento. Esse elemento é mutuamente exclusivo com o Link elemento. 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. Dica O conteúdo HTML não é validado antes de processá-lo no formulário de item de trabalho. |
Elementos pai
Elemento |
Descrição |
|---|---|
Elemento pai obrigatório. Define um campo, texto, hiperlinks ou outro elemento de controle apareça no formulário de item de trabalho. |
|
Opcional LabelText elemento. Elemento de contêiner para as informações ou o rótulo a ser exibido no formulário de item de trabalho. Para obter mais informações, consulte Referência de elementos XML LabelText e Text. |
Comentários
O Link e Content elementos são mutuamente exclusivos.
O AllowScript e ReloadOnParamChange atributos não são permitidos quando você usa o Content elemento.
Quando o controle de página da Web está configurado para exibir o HTML bruto, todos os scripts desativados. Todos os hiperlinks no conteúdo que são clicados serão abertos no navegador da Web do 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 um 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 a atualização de conteúdo
Retornar à home page 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 carregado contiver conteúdo não confiável, em seguida, o ícone está bloqueado e o ícone bloqueado é exibido.
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 será exibida uma mensagem indicando que o controle não pôde ser encontrado. Para obter mais informações, consulte Fornecer texto da ajuda, hiperlinks ou conteúdo 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 do esquema |
Definição de tipo de Item de trabalho |
Arquivo de validação |
WorkItemTypeDefinition.xsd |
Tipo de elemento |
WebpageControlOptionsType |
Pode estar vazio |
Não aplicável |
Consulte também
Conceitos
Especificar controles de formulários de itens de trabalho
Criar o formulário de item de trabalho
Outros recursos
Fornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho