XmlSerializationReader XmlSerializationReader XmlSerializationReader XmlSerializationReader Class

Definition

Controls deserialization by the XmlSerializer class.

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

public ref class XmlSerializationReader abstract : System::Xml::Serialization::XmlSerializationGeneratedCode
public abstract class XmlSerializationReader : System.Xml.Serialization.XmlSerializationGeneratedCode
type XmlSerializationReader = class
    inherit XmlSerializationGeneratedCode
Public MustInherit Class XmlSerializationReader
Inherits XmlSerializationGeneratedCode
Inheritance
XmlSerializationReaderXmlSerializationReaderXmlSerializationReaderXmlSerializationReader

Remarks

During initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that is derived from the abstract XmlSerializationReader class. XmlSerializationReader is also implemented within the .NET Framework for deserialization of XML documents into DiscoveryDocument and ServiceDescription objects.

You should not derive classes from XmlSerializationReader. Instead, call one of the Deserialize methods.

Constructors

XmlSerializationReader() XmlSerializationReader() XmlSerializationReader() XmlSerializationReader()

Initializes a new instance of the XmlSerializationReader class.

Properties

DecodeName DecodeName DecodeName DecodeName

Gets or sets a value that determines whether XML strings are translated into valid .NET Framework type names.

Document Document Document Document

Gets the XML document object into which the XML document is being deserialized.

IsReturnValue IsReturnValue IsReturnValue IsReturnValue

Gets or sets a value that should be true for a SOAP 1.1 return value.

Reader Reader Reader Reader

Gets the XmlReader object that is being used by XmlSerializationReader.

ReaderCount ReaderCount ReaderCount ReaderCount

Gets the current count of the XmlReader.

Methods

AddFixup(XmlSerializationReader+CollectionFixup) AddFixup(XmlSerializationReader+CollectionFixup) AddFixup(XmlSerializationReader+CollectionFixup) AddFixup(XmlSerializationReader+CollectionFixup)

Stores an object that contains a callback method that will be called, as necessary, to fill in .NET Framework collections or enumerations that map to SOAP-encoded arrays or SOAP-encoded, multi-referenced elements.

AddFixup(XmlSerializationReader+Fixup) AddFixup(XmlSerializationReader+Fixup) AddFixup(XmlSerializationReader+Fixup) AddFixup(XmlSerializationReader+Fixup)

Stores an object that contains a callback method instance that will be called, as necessary, to fill in the objects in a SOAP-encoded array.

AddReadCallback(String, String, Type, XmlSerializationReadCallback) AddReadCallback(String, String, Type, XmlSerializationReadCallback) AddReadCallback(String, String, Type, XmlSerializationReadCallback) AddReadCallback(String, String, Type, XmlSerializationReadCallback)

Stores an implementation of the XmlSerializationReadCallback delegate and its input data for a later invocation.

AddTarget(String, Object) AddTarget(String, Object) AddTarget(String, Object) AddTarget(String, Object)

Stores an object that is being deserialized from a SOAP-encoded multiRef element for later access through the GetTarget(String) method.

CheckReaderCount(Int32, Int32) CheckReaderCount(Int32, Int32) CheckReaderCount(Int32, Int32) CheckReaderCount(Int32, Int32)

Checks whether the deserializer has advanced.

CollapseWhitespace(String) CollapseWhitespace(String) CollapseWhitespace(String) CollapseWhitespace(String)

Removes all occurrences of white space characters from the beginning and end of the specified string.

CreateAbstractTypeException(String, String) CreateAbstractTypeException(String, String) CreateAbstractTypeException(String, String) CreateAbstractTypeException(String, String)

Creates an InvalidOperationException that indicates that an object being deserialized should be abstract.

CreateBadDerivationException(String, String, String, String, String, String) CreateBadDerivationException(String, String, String, String, String, String) CreateBadDerivationException(String, String, String, String, String, String) CreateBadDerivationException(String, String, String, String, String, String)

Populates an object from its XML representation at the current location of the XmlReader, with an option to read the inner element.

CreateCtorHasSecurityException(String) CreateCtorHasSecurityException(String) CreateCtorHasSecurityException(String) CreateCtorHasSecurityException(String)

Creates an InvalidOperationException that indicates that an object being deserialized cannot be instantiated because the constructor throws a security exception.

CreateInaccessibleConstructorException(String) CreateInaccessibleConstructorException(String) CreateInaccessibleConstructorException(String) CreateInaccessibleConstructorException(String)

Creates an InvalidOperationException that indicates that an object being deserialized cannot be instantiated because there is no constructor available.

CreateInvalidCastException(Type, Object) CreateInvalidCastException(Type, Object) CreateInvalidCastException(Type, Object) CreateInvalidCastException(Type, Object)

Creates an InvalidCastException that indicates that an explicit reference conversion failed.

CreateInvalidCastException(Type, Object, String) CreateInvalidCastException(Type, Object, String) CreateInvalidCastException(Type, Object, String) CreateInvalidCastException(Type, Object, String)

Creates an InvalidCastException that indicates that an explicit reference conversion failed.

CreateMissingIXmlSerializableType(String, String, String) CreateMissingIXmlSerializableType(String, String, String) CreateMissingIXmlSerializableType(String, String, String) CreateMissingIXmlSerializableType(String, String, String)

Creates an InvalidOperationException that indicates that a derived type that is mapped to an XML Schema data type cannot be located.

CreateReadOnlyCollectionException(String) CreateReadOnlyCollectionException(String) CreateReadOnlyCollectionException(String) CreateReadOnlyCollectionException(String)

Creates an InvalidOperationException that indicates that a SOAP-encoded collection type cannot be modified and its values cannot be filled in.

CreateUnknownConstantException(String, Type) CreateUnknownConstantException(String, Type) CreateUnknownConstantException(String, Type) CreateUnknownConstantException(String, Type)

Creates an InvalidOperationException that indicates that an enumeration value is not valid.

CreateUnknownNodeException() CreateUnknownNodeException() CreateUnknownNodeException() CreateUnknownNodeException()

Creates an InvalidOperationException that indicates that the current position of XmlReader represents an unknown XML node.

CreateUnknownTypeException(XmlQualifiedName) CreateUnknownTypeException(XmlQualifiedName) CreateUnknownTypeException(XmlQualifiedName) CreateUnknownTypeException(XmlQualifiedName)

Creates an InvalidOperationException that indicates that a type is unknown.

EnsureArrayIndex(Array, Int32, Type) EnsureArrayIndex(Array, Int32, Type) EnsureArrayIndex(Array, Int32, Type) EnsureArrayIndex(Array, Int32, Type)

Ensures that a given array, or a copy, is large enough to contain a specified index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
FixupArrayRefs(Object) FixupArrayRefs(Object) FixupArrayRefs(Object) FixupArrayRefs(Object)

Fills in the values of a SOAP-encoded array whose data type maps to a .NET Framework reference type.

GetArrayLength(String, String) GetArrayLength(String, String) GetArrayLength(String, String) GetArrayLength(String, String)

Gets the length of the SOAP-encoded array where the XmlReader is currently positioned.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetNullAttr() GetNullAttr() GetNullAttr() GetNullAttr()

Determines whether the XML element where the XmlReader is currently positioned has a null attribute set to the value true.

GetTarget(String) GetTarget(String) GetTarget(String) GetTarget(String)

Gets an object that is being deserialized from a SOAP-encoded multiRef element and that was stored earlier by AddTarget(String, Object).

GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
GetXsiType() GetXsiType() GetXsiType() GetXsiType()

Gets the value of the xsi:type attribute for the XML element at the current location of the XmlReader.

InitCallbacks() InitCallbacks() InitCallbacks() InitCallbacks()

Initializes callback methods that populate objects that map to SOAP-encoded XML data.

InitIDs() InitIDs() InitIDs() InitIDs()

Stores element and attribute names in a NameTable object.

IsXmlnsAttribute(String) IsXmlnsAttribute(String) IsXmlnsAttribute(String) IsXmlnsAttribute(String)

Determines whether an XML attribute name indicates an XML namespace.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ParseWsdlArrayType(XmlAttribute) ParseWsdlArrayType(XmlAttribute) ParseWsdlArrayType(XmlAttribute) ParseWsdlArrayType(XmlAttribute)

Sets the value of the XML attribute if it is of type arrayType from the Web Services Description Language (WSDL) namespace.

ReadElementQualifiedName() ReadElementQualifiedName() ReadElementQualifiedName() ReadElementQualifiedName()

Makes the XmlReader read the fully qualified name of the element where it is currently positioned.

ReadEndElement() ReadEndElement() ReadEndElement() ReadEndElement()

Makes the XmlReader read an XML end tag.

ReadNull() ReadNull() ReadNull() ReadNull()

Instructs the XmlReader to read the current XML element if the element has a null attribute with the value true.

ReadNullableQualifiedName() ReadNullableQualifiedName() ReadNullableQualifiedName() ReadNullableQualifiedName()

Instructs the XmlReader to read the fully qualified name of the element where it is currently positioned.

ReadNullableString() ReadNullableString() ReadNullableString() ReadNullableString()

Instructs the XmlReader to read a simple, text-only XML element that could be null.

ReadReference(String) ReadReference(String) ReadReference(String) ReadReference(String)

Reads the value of the href attribute (ref attribute for SOAP 1.2) that is used to refer to an XML element in SOAP encoding.

ReadReferencedElement() ReadReferencedElement() ReadReferencedElement() ReadReferencedElement()

Deserializes an object from a SOAP-encoded multiRef XML element.

ReadReferencedElement(String, String) ReadReferencedElement(String, String) ReadReferencedElement(String, String) ReadReferencedElement(String, String)

Deserializes an object from a SOAP-encoded multiRef XML element.

ReadReferencedElements() ReadReferencedElements() ReadReferencedElements() ReadReferencedElements()

Deserializes objects from the SOAP-encoded multiRef elements in a SOAP message.

ReadReferencingElement(String) ReadReferencingElement(String) ReadReferencingElement(String) ReadReferencingElement(String)

Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.

ReadReferencingElement(String, String, Boolean, String) ReadReferencingElement(String, String, Boolean, String) ReadReferencingElement(String, String, Boolean, String) ReadReferencingElement(String, String, Boolean, String)

Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.

ReadReferencingElement(String, String, String) ReadReferencingElement(String, String, String) ReadReferencingElement(String, String, String) ReadReferencingElement(String, String, String)

Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.

ReadSerializable(IXmlSerializable) ReadSerializable(IXmlSerializable) ReadSerializable(IXmlSerializable) ReadSerializable(IXmlSerializable)

Populates an object from its XML representation at the current location of the XmlReader.

ReadSerializable(IXmlSerializable, Boolean) ReadSerializable(IXmlSerializable, Boolean) ReadSerializable(IXmlSerializable, Boolean) ReadSerializable(IXmlSerializable, Boolean)

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

ReadString(String) ReadString(String) ReadString(String) ReadString(String)

Produces the result of a call to the ReadString() method appended to the input value.

ReadString(String, Boolean) ReadString(String, Boolean) ReadString(String, Boolean) ReadString(String, Boolean)

Returns the result of a call to the ReadString() method of the XmlReader class, trimmed of white space if needed, and appended to the input value.

ReadTypedNull(XmlQualifiedName) ReadTypedNull(XmlQualifiedName) ReadTypedNull(XmlQualifiedName) ReadTypedNull(XmlQualifiedName)

Reads an XML element that allows null values (xsi:nil = 'true') and returns a generic Nullable<T> value.

ReadTypedPrimitive(XmlQualifiedName) ReadTypedPrimitive(XmlQualifiedName) ReadTypedPrimitive(XmlQualifiedName) ReadTypedPrimitive(XmlQualifiedName)

Gets the value of the XML node at which the XmlReader is currently positioned.

ReadXmlDocument(Boolean) ReadXmlDocument(Boolean) ReadXmlDocument(Boolean) ReadXmlDocument(Boolean)

Instructs the XmlReader to read an XML document root element at its current position.

ReadXmlNode(Boolean) ReadXmlNode(Boolean) ReadXmlNode(Boolean) ReadXmlNode(Boolean)

Instructs the XmlReader to read the XML node at its current position.

Referenced(Object) Referenced(Object) Referenced(Object) Referenced(Object)

Stores an object to be deserialized from a SOAP-encoded multiRef element.

ResolveDynamicAssembly(String) ResolveDynamicAssembly(String) ResolveDynamicAssembly(String) ResolveDynamicAssembly(String)

Gets a dynamically generated assembly by name.

ShrinkArray(Array, Int32, Type, Boolean) ShrinkArray(Array, Int32, Type, Boolean) ShrinkArray(Array, Int32, Type, Boolean) ShrinkArray(Array, Int32, Type, Boolean)

Ensures that a given array, or a copy, is no larger than a specified length.

ToByteArrayBase64(Boolean) ToByteArrayBase64(Boolean) ToByteArrayBase64(Boolean) ToByteArrayBase64(Boolean)

Instructs the XmlReader to read the string value at its current position and return it as a base-64 byte array.

ToByteArrayBase64(String) ToByteArrayBase64(String) ToByteArrayBase64(String) ToByteArrayBase64(String)

Produces a base-64 byte array from an input string.

ToByteArrayHex(Boolean) ToByteArrayHex(Boolean) ToByteArrayHex(Boolean) ToByteArrayHex(Boolean)

Instructs the XmlReader to read the string value at its current position and return it as a hexadecimal byte array.

ToByteArrayHex(String) ToByteArrayHex(String) ToByteArrayHex(String) ToByteArrayHex(String)

Produces a hexadecimal byte array from an input string.

ToChar(String) ToChar(String) ToChar(String) ToChar(String)

Produces a Char object from an input string.

ToDate(String) ToDate(String) ToDate(String) ToDate(String)

Produces a DateTime object from an input string.

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

Produces a DateTime object from an input string.

ToEnum(String, Hashtable, String) ToEnum(String, Hashtable, String) ToEnum(String, Hashtable, String) ToEnum(String, Hashtable, String)

Produces a numeric enumeration value from a string that consists of delimited identifiers that represent constants from the enumerator list.

ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)
ToTime(String) ToTime(String) ToTime(String) ToTime(String)

Produces a DateTime from a string that represents the time.

ToXmlName(String) ToXmlName(String) ToXmlName(String) ToXmlName(String)

Decodes an XML name.

ToXmlNCName(String) ToXmlNCName(String) ToXmlNCName(String) ToXmlNCName(String)

Decodes an XML name.

ToXmlNmToken(String) ToXmlNmToken(String) ToXmlNmToken(String) ToXmlNmToken(String)

Decodes an XML name.

ToXmlNmTokens(String) ToXmlNmTokens(String) ToXmlNmTokens(String) ToXmlNmTokens(String)

Decodes an XML name.

ToXmlQualifiedName(String) ToXmlQualifiedName(String) ToXmlQualifiedName(String) ToXmlQualifiedName(String)

Obtains an XmlQualifiedName from a name that may contain a prefix.

UnknownAttribute(Object, XmlAttribute) UnknownAttribute(Object, XmlAttribute) UnknownAttribute(Object, XmlAttribute) UnknownAttribute(Object, XmlAttribute)

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

UnknownAttribute(Object, XmlAttribute, String) UnknownAttribute(Object, XmlAttribute, String) UnknownAttribute(Object, XmlAttribute, String) UnknownAttribute(Object, XmlAttribute, String)

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

UnknownElement(Object, XmlElement) UnknownElement(Object, XmlElement) UnknownElement(Object, XmlElement) UnknownElement(Object, XmlElement)

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

UnknownElement(Object, XmlElement, String) UnknownElement(Object, XmlElement, String) UnknownElement(Object, XmlElement, String) UnknownElement(Object, XmlElement, String)

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

UnknownNode(Object) UnknownNode(Object) UnknownNode(Object) UnknownNode(Object)

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

UnknownNode(Object, String) UnknownNode(Object, String) UnknownNode(Object, String) UnknownNode(Object, String)

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

UnreferencedObject(String, Object) UnreferencedObject(String, Object) UnreferencedObject(String, Object) UnreferencedObject(String, Object)

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

Applies to

See also