XmlSerializationReader.UnreferencedObject(String, Object) Method

Definition

Raises an UnreferencedObject event for the current position of the XmlReader.

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

protected:
 void UnreferencedObject(System::String ^ id, System::Object ^ o);
protected void UnreferencedObject (string? id, object? o);
protected void UnreferencedObject (string id, object o);
member this.UnreferencedObject : string * obj -> unit
Protected Sub UnreferencedObject (id As String, o As Object)

Parameters

id
String

A unique string that is used to identify the unreferenced object, subsequently accessible through the UnreferencedId property.

o
Object

An object that the XmlSerializer is attempting to deserialize, subsequently accessible through the UnreferencedObject property.

Remarks

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

SOAP encoding, as specified in Section 5 of the SOAP 1.1 specification, allows for elements referenced multiple times in a SOAP message (or optionally, just once) to be referred by an href attribute in the main message. An UnreferencedObject event occurs when such an element appears, but there is no href reference to it.

Add a handler method to UnreferencedObject to provide custom handling for unreferenced objects while the XmlSerializer executes its Deserialize method.

Applies to