XmlTextWriter::WriteStartElement Method (String^, String^, String^)

 

Writes the specified start tag and associates it with the given namespace and prefix.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public:
virtual void WriteStartElement(
	String^ prefix,
	String^ localName,
	String^ ns
) override

Parameters

prefix
Type: System::String^

The namespace prefix of the element.

localName
Type: System::String^

The local name of the element.

ns
Type: System::String^

The namespace URI to associate with the element. If this namespace is already in scope and has an associated prefix then the writer automatically writes that prefix also.

Exception Condition
InvalidOperationException

The writer is closed.

System_CAPS_noteNote

Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter::Create method and the XmlWriterSettings class to take advantage of new functionality.

After calling this method you can either write attributes or create content using WriteComment, WriteString, or WriteStartElement for child elements. You can close the element with WriteEndElement at which time an end tag is written out.

The following example writes out a book.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   String^ filename = "sampledata.xml";
   XmlTextWriter^ writer = gcnew XmlTextWriter( filename, nullptr );

   //Use indenting for readability.
   writer->Formatting = Formatting::Indented;
   writer->WriteComment( "sample XML fragment" );

   //Write an element (this one is the root).
   writer->WriteStartElement( "bookstore" );

   //Write the namespace declaration.
   writer->WriteAttributeString( "xmlns", "bk", nullptr, "urn:samples" );
   writer->WriteStartElement( "book" );

   //Lookup the prefix and then write the ISBN attribute.
   String^ prefix = writer->LookupPrefix( "urn:samples" );
   writer->WriteStartAttribute( prefix, "ISBN", "urn:samples" );
   writer->WriteString( "1-861003-78" );
   writer->WriteEndAttribute();

   //Write the title.
   writer->WriteStartElement( "title" );
   writer->WriteString( "The Handmaid's Tale" );
   writer->WriteEndElement();

   //Write the price.
   writer->WriteElementString( "price", "19.95" );

   //Write the style element.
   writer->WriteStartElement( prefix, "style", "urn:samples" );
   writer->WriteString( "hardcover" );
   writer->WriteEndElement();

   //Write the end tag for the book element.
   writer->WriteEndElement();

   //Write the close tag for the root element.
   writer->WriteEndElement();

   //Write the XML to file and close the writer.
   writer->Flush();
   writer->Close();

   //Read the file back in and parse to ensure well formed XML.
   XmlDocument^ doc = gcnew XmlDocument;

   //Preserve white space for readability.
   doc->PreserveWhitespace = true;

   //Load the file
   doc->Load( filename );

   //Write the XML content to the console.
   Console::Write( doc->InnerXml );
}

.NET Framework
Available since 1.1
Return to top
Show: