XmlHelperOverrideElement Method (IXmlElement, IXmlElement, String) |
Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02
Override the values of the specified base element with values
from the specified override element.
Namespace:
Tangosol.Run.Xml
Assembly:
Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
Syntaxpublic static void OverrideElement(
IXmlElement xmlBase,
IXmlElement xmlOverride,
string idAttrName
)
Parameters
- xmlBase
- Type: Tangosol.Run.XmlIXmlElement
Base IXmlElement.
- xmlOverride
- Type: Tangosol.Run.XmlIXmlElement
Override IXmlElement.
- idAttrName
- Type: SystemString
Attribute name that serves as an identifier allowing to match
elements with the same name; if not specified all attributes have
to match for an override.
ExceptionsException | Condition |
---|
InvalidOperationException |
If the base element is immutable or there is ambiguity between
the override and base elements.
|
Remarks
The values are only overriden if there is an exact match between
the element paths and an attribute value for the specified
attribute name. Empty override values are ignored. Override
elements that do not match any of the base elements are just
copied over. No ambiguity is allowed.
For example, if the base element has more then one child with the
same name and the specified attribute's value then the override
is not allowed.
See Also