• Article

XmlWriter.WriteStartElement Method (String, String)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

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

Syntax

'Declaration
Public Sub WriteStartElement ( _
    localName As String, _
    ns As String _
)

public void WriteStartElement(
    string localName,
    string ns
)

Parameters

  • ns
    Type: System.String
    The namespace URI to associate with the element. If this namespace is already in scope and has an associated prefix, the writer automatically writes that prefix also.

Exceptions

Exception Condition
InvalidOperationException

The writer is closed.

Remarks

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 either WriteEndElement or WriteFullEndElement. For example, the following C# code:

 writer.WriteStartElement("item",null);
 writer.WriteString("some text");
 writer.WriteEndElement();

Generates the following output:

 <item>some text</item>

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.