XmlSerializationWriter.TopLevelElement Method

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

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Initializes object references only while serializing a SOAP-encoded SOAP message.

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

Syntax

'Declaration
Protected Sub TopLevelElement
protected void TopLevelElement()

Remarks

The protected members of XmlSerializationWriter are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.

SOAP encoding allows a unique XML element to appear once within a SOAP message as a multiRef element and to be referenced any number of times by substitute elements. The TopLevelElement method helps keep track of the objects that can be serialized as multiRef elements.

SOAP encoding is described in Section 5 of the SOAP 1.1 specification.

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

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