System.Xml.Serialization.XmlSerializationWriter.WritePotentiallyReferencingElement Method

Writes a SOAP message XML element that can contain a reference to a <multiRef> XML element for a given object.

Syntax

protected void WritePotentiallyReferencingElement (string n, string ns, object o, Type ambientType)

Parameters

n
The local name of the XML element to write.
ns
The namespace of the XML element to write.
o
The object being serialized either in the current XML element or a multiRef element that referenced by the current element.
ambientType
The type stored in the object's type mapping (as opposed to the object's type found directly through the typeof operation).

Remarks

The protected members of System.Xml.Serialization.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 identified by an id attribute. The id value can be referenced multiple times using href attributes (or ref attributes in SOAP 1.2) in substitute elements.

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

Requirements

Namespace: System.Xml.Serialization
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0