RemoveChildElement

Description

The RemoveChildElement method is overloaded:

  • Syntax 1 removes the first child PBDOM_ELEMENT object (one level deep) that has the local name provided and belongs to no namespace.

  • Syntax 2 removes the first child PBDOM_ELEMENT object (one level deep) that has the local name provided and belongs to the specified namespace.

Syntax

For this syntax

See

RemoveChildElement(string strElementName)

RemoveChildElement Syntax 1

RemoveChildElement(string strElementName, string strNamespacePrefix, string strNamespaceUri)

RemoveChildElement Syntax 2


RemoveChildElement Syntax 1

Description

Removes the first child PBDOM_ELEMENT object (one level deep) that has the local name provided and belongs to no namespace.

Syntax

pbdom_element_name.RemoveChildElement(string strElementName)

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

strElementName

The name of the child PBDOM_ELEMENT object to remove


Return value

Boolean.

Returns true if the specified PBDOM_ELEMENT object was removed, and false otherwise.

Throws

EXCEPTION_INVALID_ARGUMENT -- If the input parameter is invalid, for example, null.

EXCEPTION_INVALID_STRING -- If the input element name is invalid.

See also

GetChildElement

GetChildElements

HasChildElements

HasChildren

IsRootElement

RemoveChildElement Syntax 2

RemoveChildElements

RemoveChildElement Syntax 2

Description

Removes the first child PBDOM_ELEMENT object (one level deep) that has the local name provided and belongs to the specified namespace.

Syntax

pbdom_element_name.RemoveChildElement(string strElementName, string strNamespacePrefix, string strNamespaceUri)

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

strElementName

The name of the PBDOM_ELEMENT object to remove

strNamespacePrefix

Prefix of the namespace of the PBDOM_ELEMENT object to remove

strNamespaceUri

URI of the namespace of the PBDOM_ATTRIBUTE to remove


Return value

Boolean.

Returns true if the specified PBDOM_ELEMENT object was removed and false otherwise.

Throws

EXCEPTION_INVALID_ARGUMENT -- If the input parameter is invalid, for example, null.

EXCEPTION_INVALID_STRING -- If the input element name is invalid or the input namespace prefix or URI is invalid.

See also

GetChildElement

GetChildElements

HasChildElements

HasChildren

IsRootElement

RemoveChildElement Syntax 1

RemoveChildElements