GetName

Description

Retrieves the local name of the PBDOM_ATTRIBUTE object.

Syntax

pbdom_attribute_name.GetName()

Argument

Description

pbdom_attribute_name

The name of the PBDOM_ATTRIBUTE


Return value

String.

Throws

EXCEPTION_USE_OF_UNNAMED_PBDOM_OBJECT -- If this PBDOM_ATTRIBUTE does not have or has not been assigned a user-defined name.

Examples

  1. When the GetName method is invoked for the attribute name in the following element, it returns the string ATTRIBUTE_1:

    <abc ATTRIBUTE_1="My Attribute">
  2. When the GetName method is invoked for the name of the eMusic:Type attribute in the following element, it returns the string Type:

    <eMusic:CD xmlns:eMusic="http://www.eMusic_Records.com" eMusic:Type="Jazz"/>

The namespace prefix is not part of the return string.

Usage

For an XML attribute that appears in the form [namespace_prefix]:[attribute_name], the local attribute name is attribute_name. Where the XML attribute has no namespace prefix, the local name is simply the attribute name.

Use the GetNamespacePrefix method to obtain the namespace prefix for a PBDOM_ATTRIBUTE object. Use the GetQualifiedName method to obtain the fully qualified name for a PBDOM_ATTRIBUTE object.

See also

GetNamespacePrefix

GetNamespaceUri

GetQualifiedName

SetName

SetNamespace