AttributeMatchPath
Das <AttributeMatchPath>-Element kann durch eine Websteuerelementkonfiguration verwendet werden, um die gewünschte Steuerelement auf dem derzeit geladenenen HTML-Dokument mithilfe der Steuerelement-Attribute zu suchen. Der "Zuordnungspfad" ist eine geordnete Liste von Schlüssel-/Wert-Paaren, die angewendet wird, indem durch jedes Element in der HTML``Document Object Model (DOM) iteriert wird, wobei Attribute entlag der Knoten des Zuordnungspfades zugeordnet werden. Jeder Schlüssel stellt den Namen des Attributs dar, das zugeordnet werden soll, und der Wert wird mit dem zugeordneten Attributwert im HTML-Dokument abgeglichen. Nachdem ein Schlüssel/Wert abgeglichen ist, wird das nächste Schlüssel/Wert-Paar in der Reihenfolge verwendet, um jedes Element in DOM zu vergleichen. Beachten Sie, dass, wenn keyn+1 = keyn ist, das Abgleichen mit dem neuen Schlüssel/Wert-Paar mit dem nächsten Elementknoten in DOM beginnt, nicht mit dem aktuellen Knoten.
<AttributeMatchPath> Syntax
Das <AttributeMatchPath>-Element kann in spezifischen Frames innerhlb einer HTML-Anwendung ein Ziel sein.
<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>
<AttributeMatchPath> Elemente
In der folgenden Tabelle werden die Elemente von <AttributeMatchPath> beschrieben.
| Element | Beschreibung |
|---|---|
| Framename | Orndet den Framenamen des IFrame zu. |
| Framesrc | Orndet die Quelle des IFrame zu. |
| Framematch | Gleicht das n-te des angegebenen Frames ab; Standardwert ist 1. |
| Matchtype | Gibt an, wie die Beschriftung abgeglichen werden soll. Mögliche Werte lauten equals, startswith, endswith oder contains; jeder andere Wert löst eine Ausnahme aus. |
Wenn eine Webanwendung mehrere Frames mit einem gegebenen Namen hat, können Sie angeben, nach dem zweiten oder dritten Frames dieses Namens zu suchen. Das framematch-Attribut ist nicht zwingend, es wird jedoch vorausgesetzt, dass es 1 ist, wenn nicht anders angegeben. If framematch ist festgelegt, framename or framesrc muss festgelegt werden; andernfalls wird eine Ausnahme "Frame nicht gefunden" ausgelöst.
Notiz
Wird keines der AttributeMatchPath-Attribute angegeben, findet der Vorgang im Fenster der oberster Ebene statt, als ob es ein Frames wäre. Wenn sowohl framename als auch framesrc festgelegt sind, hat framesrc Vorrang.
Im folgenden Beispiel wird matchtype im attributeValueToMatch verwendet.
<AttributeMatchPath>
<key1>val1</key1>
<key2>val2</key2>
<key3[matchtype="equals|startswith|endswith|contains"]>attributeValueToMatch</key3>
.
<keyn>valn</keyn>
</AttributeMatchPath>
Das folgende Beispiel zeigt einen vollständigen Attributabgleichungspfad für ein Test-Tag.
Page code:
<Test FirstName='John' LastName='Smith'/>
Match path used in control description:
<AttributeMatchPath>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
</AttributeMatchPath>
Notiz
Es wird dringend empfohlen, nur ID und/oder Name als Suchattribute zu verwenden. Die anderen Attribute haben eine negative Auswirkungen auf die Leistung.