AttributeMatchPath
O elemento <AttributeMatchPath> pode ser utilizado por uma configuração de controlo Web para localizar o controlo pretendido no documento HTML atualmente carregado utilizando os controlos dos atributos. O "caminho de correspondência” é uma lista ordenada de pares chave/valor que é aplicada iterando através de cada elemento no HTMLDocument Object Model (DOM), correspondendo atributos ao longo dos nós do caminho de correspondência. Cada chave representa o nome do atributo a corresponder e o valor é correspondido com o valor do atributo atribuído no documento HTML. Após uma chave/valor corresponder, o próximo par chave/valor é utilizado para comparar com cada elemento no DOM. Note que quando keyn+1 = keyn, a combinação com o novo par chave/valor começa com o próximo nó do elemento no DOM, não com o nó atual.
Neste Tópico
Sintaxe de <AttributeMatchPath>
Elementos de<AttributeMatchPath>
Sintaxe de <AttributeMatchPath>
O elemento <AttributeMatchPath> pode ser utilizado em frames específicos numa aplicação HTML.
<AttributeMatchPath [framename=""|framesrc=""] [framematch="n"] [matchtype="equals|startswith|endswith|contains"]>
<attributeName1 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch1
</attributeName1>
<attributeName2 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch2
</attributeName2>
…
<attributeNamen [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatchn
</attributeNamen>
</AttributeMatchPath>
Elementos de<AttributeMatchPath>
A tabela seguinte descreve os elementos de <AttributeMatchPath>
| Elemento | Descrição |
|---|---|
Framename |
Corresponde o nome da frame de IFrame. |
Framesrc |
Corresponde a origem de IFrame. |
Framematch |
Corresponde a enésima frame especificada; a predefinição é 1. |
Matchtype |
Especifica como a legenda tem de ser combinada. Os valores possíveis são equals, startswith, endswith ou contains e qualquer outro valor emitirá uma exceção. |
Por exemplo, se uma aplicação web tem mais de um frame com um nome determinado, pode especificar para procurar o segundo ou terceiro frames com esse nome. O atributo framematch não é obrigatório; no entanto, assume-se que é 1 exceto se especificado. Se framematch for especificado, framename ou framesrc têm de ser especificado; caso contrário, é emitida uma exceção "Frame não encontrado".
Nota
Se nenhum dos atributos AttributeMatchPath for fornecido, a operação ocorrerá na janela de nível superior como se tivesse uma frame. Se framename e framesrc for especificado, framesrc tem a precedência.
No seguinte exemplo, matchtype é utilizado em attributeValueToMatch.
<AttributeMatchPath>
<key1>val1</key1>
<key2>val2</key2>
<key3[matchtype="equals|startswith|endswith|contains"]>attributeValueToMatch</key3>
.
<keyn>valn</keyn>
</AttributeMatchPath>
O seguinte exemplo mostra um caminho completo de correspondência de atributo para uma etiqueta Test.
Page code:
<Test FirstName='John' LastName='Smith'/>
Match path used in control description:
<AttributeMatchPath>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
</AttributeMatchPath>
Nota
É vivamente recomendado que utilize apenas o ID e/ou o nome como atributos de pesquisa. Os outros atributos têm um negativo impacto no desempenho.
Consulte Também
Conceitos
WebDDA
Utilizar adaptadores orientados por dados (DDAs)
Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.