PBDOM_ELEMENT:

AddContent Syntax 1 method

Description

Adds a new PBDOM_OBJECT into a PBDOM_ELEMENT
object. The added PBDOM_OBJECT becomes a child of the PBDOM_ELEMENT
object.

Syntax

<span>pbdom_element_name.</span>AddContent(pbdom_object<span> pbdom_object_ref</span>)

1	<span>pbdom_element_name.</span>AddContent(pbdom_object<span> pbdom_object_ref</span>)

Argument	Description
pbdom_element_name	The name of a PBDOM_ELEMENT object
pbdom_object_ref	The PBDOM_OBJECT to add

Return Values

PBDOM_OBJECT. The PBDOM_ELEMENT object modified
and returned as a PBDOM_OBJECT.

Throws

EXCEPTION_INAPPROPRIATE_USE_OF_PBDOM_OBJECT – If
an invalid PBDOM_OBJECT is added. See description section
below on the valid PBDOM_OBJECTs that can be added to a
PBDOM_ELEMENT object. This exception is also thrown if
the input PBDOM_OBJECT is this PBDOM_ELEMENT object
itself.

EXCEPTION_USE_OF_UNNAMED_PBDOM_OBJECT – If
the input PBDOM_OBJECT has not been given a user-defined
name.

EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE – If
the input PBDOM_OBJECT is not associated with a derived
PBDOM_OBJECT.

EXCEPTION_PBDOM_OBJECT_ALREADY_HAS_PARENT – If
the input PBDOM_OBJECT already has a parent PBDOM_OBJECT.

EXCEPTION_HIERARCHY_ERROR – If
adding the input PBDOM_OBJECT will cause the current PBDOM_ELEMENT
object to be no longer well–formed.

Examples

The AddContent method is invoked
for the Element_2 PBDOM_ELEMENT object
in the following XML fragment:

&#160;&#160;&#160;&#160;&#160;&lt;Element_1&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_1/&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_2/&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_3/&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;/Element_1&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;Element_2&gt;Element 2 Text&lt;/Element_2&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;Element_3/&gt;

1	<Element_1><br>          <Element_1_1/><br>          <Element_1_2/><br>          <Element_1_3/><br>     </Element_1><br>     <Element_2>Element 2 Text</Element_2><br>     <Element_3/>

The AddContent is invoked from the following
PowerScript code, where pbdom_elem_2 represents
the Element_2 object:

PBDOM_ELEMENT pbdom_elem<br>pbdom_elem = Create PBDOM_ELEMENT<br>pbdom_elem.SetName("Sub_Element")<br>pbdom_elem.AddContent("Sub Element Text")<br>pbdom_elem_2.AddContent (pbdom_elem)

1	PBDOM_ELEMENT pbdom_elem<br>pbdom_elem = Create PBDOM_ELEMENT<br>pbdom_elem.SetName("Sub_Element")<br>pbdom_elem.AddContent("Sub Element Text")<br>pbdom_elem_2.AddContent (pbdom_elem)

The following XML fragment results:

&#160;&#160;&#160;&#160;&#160;&lt;Element_1&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_1/&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_2/&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Element_1_3/&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;/Element_1&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;Element_2&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Element 2 Text<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;Sub_Element&gt;<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Sub Element Text<br>&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&lt;/Sub_Element&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;Element_2/&gt;<br>&#160;&#160;&#160;&#160;&#160;&lt;Element_3/&gt;

<Element_1>           <Element_1_1/>           <Element_1_2/>           <Element_1_3/>      </Element_1>      <Element_2>           Element 2 Text           <Sub_Element>                     Sub Element Text           </Sub_Element>      <Element_2/>      <Element_3/>

Usage

Only the following PBDOM_OBJECT types can be validly
added to a PBDOM_ELEMENT object:

PBDOM_ELEMENT
PBDOM_CDATA
PBDOM_COMMENT
PBDOM_ENTITYREFERENCE
PBDOM_PROCESSINGINSTRUCTION
PBDOM_TEXT

Connection Information

AddContent Syntax 1 – PB Docs 126