RemoveAttribute

Description

The RemoveAttribute method is overloaded:

  • Syntax 1 removes a PBDOM_ATTRIBUTE from its owner PBDOM_ELEMENT object using a reference to the PBDOM_ATTRIBUTE.

  • Syntax 2 removes a PBDOM_ATTRIBUTE from its owner PBDOM_ELEMENT object using the name of the PBDOM_ATTRIBUTE.

  • Syntax 3 removes a PBDOM_ATTRIBUTE from its owner PBDOM_ELEMENT object using the name and namespace of the PBDOM_ATTRIBUTE.

Syntax

For this syntax

See

RemoveAttribute(pbdom_attribute pbdom_attribute_ref)

RemoveAttribute Syntax 1

RemoveAttribute(string strAttributeName)

RemoveAttribute Syntax 2

RemoveAttribute(string strAttributeName, string strNamespacePrefix, string strNamespaceUri)

RemoveAttribute Syntax 3


RemoveAttribute Syntax 1

Description

Removes a PBDOM_ATTRIBUTE from its owner PBDOM_ELEMENT object.

Syntax

pbdom_element_name.RemoveAttribute(pbdom_attribute pbdom_attribute_ref)

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

pbdom_attribute_ref

The PBDOM_ATTRIBUTE object to remove from this PBDOM_ELEMENT object


Return value

Boolean.

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

RemoveAttribute Syntax 2

Description

Removes a PBDOM_ATTRIBUTE specified by the name provided that is not contained in a namespace. If no such PBDOM_ATTRIBUTE exists, RemoveAttribute does nothing.

Syntax

pbdom_element_name.RemoveAttribute(string strAttributeName)

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

strAttributeName

The name of the PBDOM_ATTRIBUTE object to remove


Return value

Boolean.

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

RemoveAttribute Syntax 3

Description

Removes a PBDOM_ATTRIBUTE specified by the name and namespace provided. If no such PBDOM_ATTRIBUTE exists, RemoveAttribute does nothing.

Syntax

bdom_element_name.RemoveAttribute(string strAttributeName, string strNamespacePrefix, string strNamespaceUri)

Argument

Description

pbdom_element_name

The name of a PBDOM_ELEMENT object

strAttributeName

The name of the PBDOM_ATTRIBUTE object to remove

strNamespacePrefix

Prefix of the namespace of the PBDOM_ATTRIBUTE to remove

strNamespaceUri

URI of the namespace of the PBDOM_ATTRIBUTE to remove


Return value

Boolean.

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

Throws

EXCEPTION_INVALID_ARGUMENT -- If any of the input parameters is invalid, for example, null.

EXCEPTION_INVALID_STRING -- If the input Attribute Name is invalid (for example, contains a colon), or if the namespace prefix or URI is invalid.

EXCEPTION_MEMORY_ALLOCATION_FAILURE -- If a memory allocation failure occurred during the execution of this method.