This documentation is archived and is not being maintained.

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

This method 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)

protected void WritePotentiallyReferencingElement (
	string n,
	string ns,
	Object o,
	Type ambientType,
	bool suppressReference,
	bool isNullable
)
protected void WritePotentiallyReferencingElement (
	String n, 
	String ns, 
	Object o, 
	Type ambientType, 
	boolean suppressReference, 
	boolean isNullable
)
protected function WritePotentiallyReferencingElement (
	n : String, 
	ns : String, 
	o : Object, 
	ambientType : Type, 
	suppressReference : boolean, 
	isNullable : boolean
)
Not applicable.

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

suppressReference

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

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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: