StartElement Method

Writes the opening tag of an XML element.

Syntax

xmlwcontrol.StartElement Name, NamespaceURI

Remarks

Writes the opening tag of a new XML element. If an XML element is already opened, then this element is written as a child.

If Name is a local name without a prefix, the control will automatically introduce a new xmlns="NamespaceURI" attribute if necessary.

If Name is in the form prefix:local, then control will automatically introduce a new xmlns:prefix="NamespaceURI" as necessary.

When calling WriteElement or StartElement, if a NamespaceURI is not specified an empty namespace will be defined for the element. If a namespace should be associated with the element, a NamespaceURI value must be provided. When creating the XML, the control will determine if the namespace already exists to avoid duplicate definitions of the same namespace. For example, to create this XML:

<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>
</book>

Use the code:

xmlw.StartElement("book", "urn:loc.gov:books");
xmlw.WriteAttribute("xmlns:isbn", "", "urn:ISBN:0-395-36341-6");
xmlw.WriteElement("title", "urn:loc.gov:books", "Cheaper by the Dozen");
xmlw.WriteElement("isbn:number", "urn:ISBN:0-395-36341-6", "1568491379");
xmlw.Close();

In the above example the "title" element uses the default namespace "urn:loc.gov:books" and the "number" element uses the "urn:ISBN:0-395-36341-6" namespace as defined for the "isbn" prefix.