Export (0) Print
Expand All

XmlSerializationWriter.WritePotentiallyReferencingElement Method (String, String, Object, Type, Boolean, Boolean)

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

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

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

member WritePotentiallyReferencingElement : 
        n:string * 
        ns:string * 
        o:Object * 
        ambientType:Type * 
        suppressReference:bool * 
        isNullable:bool -> unit

Parameters

n
Type: System.String

The local name of the XML element to write.

ns
Type: System.String

The namespace of the XML element to write.

o
Type: System.Object

The object being serialized either in the current XML element or a multiRef element that referenced by the current element.

ambientType
Type: System.Type

The type stored in the object's type mapping (as opposed to the object's type found directly through the typeof operation).

suppressReference
Type: System.Boolean

true to serialize the object directly into the XML element rather than make the element reference another element that contains the data; otherwise, false.

isNullable
Type: System.Boolean

true to write an xsi:nil='true' attribute if the object to serialize is a null reference (Nothing in Visual Basic); otherwise, false.

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 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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft