Oracle® Coherence .NET API Reference Release 3.7.1
E22844-03

Ensure that a child element exists.

Namespace: Tangosol.Run.Xml
Assembly: Coherence (in Coherence.dll) Version: 3.7.1.23 (3.7.1.23)

Syntax

C#
public virtual IXmlElement EnsureElement( string path )

Parameters

path: Type: System..::.String
Element path.

Return Value

The existing or new IXmlElement object.

Implements

IXmlElement..::.EnsureElement(String)

Remarks

This is a convenience method. It combines the functionality of FindElement(String) and AddElement(String). If any part of the path does not exist create new child elements to match the path.

Exceptions

Exception	Condition
System..::.ArgumentException	If the name is null or if any part of the path is not a legal XML tag name.
System..::.InvalidOperationException	If any element in the path is immutable or otherwise can not add a child element.