AttributeMatchPath
El elemento <AttributeMatchPath> se puede usar por una configuración de control web para buscar el control deseado en el documento HTML cargado actualmente utilizando los atributos de controles. La "ruta de correspondencia" es una lista ordenada de pares de clave/valor que se aplica mediante iteración a través de cada elemento en el HTML``Document Object Model (DOM), comparando los atributos a lo largo de los nodos de la ruta de correspondencia. Cada clave representa el nombre del atributo que debe coincidir, y el valor coincide con el valor de atributo asignado en el documento HTML. Cuando coincide una clave/valor, el siguiente par de clave/valor en la secuencia se usa para comparar cada elemento en DOM. Tenga en cuenta que cuando keyn+1 = keyn, coincidiendo con el nuevo par de clave/valor empieza con el siguiente nodo de elemento en DOM, no con el nodo actual.
Sintaxis de <AttributeMatchPath>
El elemento <AttributeMatchPath> se puede ser el objetivo en los marcos específicos de una aplicación 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>
En la siguiente tabla se describen los elementos de <AttributeMatchPath>
| Elemento | Descripción |
|---|---|
| Framename | Coincide con el nombre de marco del IFrame. |
| Framesrc | Coincide con el origen del IFrame. |
| Framematch | Coincide con el enésimo marco especificado; el valor predeterminado es 1. |
| Matchtype | Especifica cómo debe coincidir el título. Los valores posibles son equals, startswith, endswith o contains, cualquier otro valor lanzará una excepción. |
Por ejemplo, si una aplicación web tiene más de un marco con un nombre dado, puede especificar buscar el segundo o el tercer marco de ese nombre. El atributo framematch no es obligatorio; no obstante se da por hecho que es 1 a menos que se especifique lo contrario. Si se especifica framematch, framename o framesrc debe especificarse; de lo contrario, se lanzará una excepción "Marco no encontrado".
Nota
Si no se proporciona ninguno de los atributos de AttributeMatchPath, la operación ocurrirá en la ventana de nivel superior como si fuera un marco. Si se especifican framename y framesrc, framesrc tiene prioridad.
En el siguiente ejemplo, matchtype se usa en attributeValueToMatch.
<AttributeMatchPath>
<key1>val1</key1>
<key2>val2</key2>
<key3[matchtype="equals|startswith|endswith|contains"]>attributeValueToMatch</key3>
.
<keyn>valn</keyn>
</AttributeMatchPath>
El siguiente ejemplo muestra una ruta de correspondencia de atributo completa para una etiqueta Test.
Page code:
<Test FirstName='John' LastName='Smith'/>
Match path used in control description:
<AttributeMatchPath>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
</AttributeMatchPath>
Nota
Se recomienda encarecidamente usar sólo Id. y/o el nombre como atributos de búsqueda. Los otros atributos tendrán un impacto negativo en el rendimiento.