Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

XmlSerializationReader Class

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

Controls deserialization by the XmlSerializer class.

Namespace:  System.Xml.Serialization
Assembly:  System.Xml (in System.Xml.dll)
public abstract class XmlSerializationReader : XmlSerializationGeneratedCode

The XmlSerializationReader type exposes the following members.

  NameDescription
Protected methodXmlSerializationReaderInfrastructure. Initializes a new instance of the XmlSerializationReader class.
Top
  NameDescription
Protected propertyDecodeNameInfrastructure. Gets or sets a value that determines whether XML strings are translated into valid .NET Framework type names.
Protected propertyDocumentGets the XML document object into which the XML document is being deserialized.
Protected propertyIsReturnValueInfrastructure. Gets or sets a value that should be true for a SOAP 1.1 return value.
Protected propertyReaderGets the XmlReader object that is being used by XmlSerializationReader.
Protected propertyReaderCountGets the current count of the XmlReader.
Top
  NameDescription
Protected methodAddFixup(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.
Protected methodAddFixup(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.
Protected methodAddReadCallbackStores an implementation of the XmlSerializationReadCallback delegate and its input data for a later invocation.
Protected methodAddTargetStores an object that is being deserialized from a SOAP-encoded multiRef element for later access through the GetTarget method.
Protected methodCheckReaderCountChecks whether the deserializer has advanced.
Protected methodCollapseWhitespaceRemoves all occurrences of white space characters from the beginning and end of the specified string.
Protected methodCreateAbstractTypeExceptionCreates an InvalidOperationException that indicates that an object being deserialized should be abstract.
Protected methodCreateBadDerivationExceptionPopulates an object from its XML representation at the current location of the XmlReader, with an option to read the inner element.
Protected methodCreateCtorHasSecurityExceptionCreates an InvalidOperationException that indicates that an object being deserialized cannot be instantiated because the constructor throws a security exception.
Protected methodCreateInaccessibleConstructorExceptionCreates an InvalidOperationException that indicates that an object being deserialized cannot be instantiated because there is no constructor available.
Protected methodCreateInvalidCastException(Type, Object)Creates an InvalidCastException that indicates that an explicit reference conversion failed.
Protected methodCreateInvalidCastException(Type, Object, String)Creates an InvalidCastException that indicates that an explicit reference conversion failed.
Protected methodCreateMissingIXmlSerializableTypeCreates an InvalidOperationException that indicates that a derived type that is mapped to an XML Schema data type cannot be located.
Protected methodCreateReadOnlyCollectionExceptionCreates an InvalidOperationException that indicates that a SOAP-encoded collection type cannot be modified and its values cannot be filled in.
Protected methodCreateUnknownConstantExceptionCreates an InvalidOperationException that indicates that an enumeration value is not valid.
Protected methodCreateUnknownNodeExceptionCreates an InvalidOperationException that indicates that the current position of XmlReader represents an unknown XML node.
Protected methodCreateUnknownTypeExceptionCreates an InvalidOperationException that indicates that a type is unknown.
Protected methodEnsureArrayIndexEnsures that a given array, or a copy, is large enough to contain a specified index.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Protected methodFixupArrayRefsFills in the values of a SOAP-encoded array whose data type maps to a .NET Framework reference type.
Protected methodGetArrayLengthGets the length of the SOAP-encoded array where the XmlReader is currently positioned.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Protected methodGetNullAttrInfrastructure. Determines whether the XML element where the XmlReader is currently positioned has a null attribute set to the value true.
Protected methodGetTargetInfrastructure. Gets an object that is being deserialized from a SOAP-encoded multiRef element and that was stored earlier by AddTarget.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodGetXsiTypeGets the value of the xsi:type attribute for the XML element at the current location of the XmlReader.
Protected methodInitCallbacksInitializes callback methods that populate objects that map to SOAP-encoded XML data.
Protected methodInitIDsInfrastructure. Stores element and attribute names in a NameTable object.
Protected methodIsXmlnsAttributeInfrastructure. Determines whether an XML attribute name indicates an XML namespace.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodParseWsdlArrayTypeSets the value of the XML attribute if it is of type arrayType from the Web Services Description Language (WSDL) namespace.
Protected methodReadElementQualifiedNameMakes the XmlReader read the fully qualified name of the element where it is currently positioned.
Protected methodReadEndElementMakes the XmlReader read an XML end tag.
Protected methodReadNullInstructs the XmlReader to read the current XML element if the element has a null attribute with the value true.
Protected methodReadNullableQualifiedNameInstructs the XmlReader to read the fully qualified name of the element where it is currently positioned.
Protected methodReadNullableStringInstructs the XmlReader to read a simple, text-only XML element that could be null.
Protected methodReadReferenceReads the value of the href attribute (ref attribute for SOAP 1.2) that is used to refer to an XML element in SOAP encoding.
Protected methodReadReferencedElement()Deserializes an object from a SOAP-encoded multiRef XML element.
Protected methodReadReferencedElement(String, String)Deserializes an object from a SOAP-encoded multiRef XML element.
Protected methodReadReferencedElementsDeserializes objects from the SOAP-encoded multiRef elements in a SOAP message.
Protected methodReadReferencingElement(String)Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.
Protected methodReadReferencingElement(String, String, String)Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.
Protected methodReadReferencingElement(String, String, Boolean, String)Deserializes an object from an XML element in a SOAP message that contains a reference to a multiRef element.
Protected methodReadSerializable(IXmlSerializable)Populates an object from its XML representation at the current location of the XmlReader.
Protected methodReadSerializable(IXmlSerializable, Boolean)This method supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Protected methodReadString(String)Produces the result of a call to the ReadString method appended to the input value.
Protected methodReadString(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.
Protected methodReadTypedNullReads an XML element that allows null values (xsi:nil = 'true') and returns a generic Nullable<T> value.
Protected methodReadTypedPrimitiveGets the value of the XML node at which the XmlReader is currently positioned.
Protected methodReadXmlDocumentInstructs the XmlReader to read an XML document root element at its current position.
Protected methodReadXmlNodeInstructs the XmlReader to read the XML node at its current position.
Protected methodReferencedStores an object to be deserialized from a SOAP-encoded multiRef element.
Protected methodStatic memberResolveDynamicAssemblyInfrastructure. Gets a dynamically generated assembly by name.
Protected methodShrinkArrayEnsures that a given array, or a copy, is no larger than a specified length.
Protected methodToByteArrayBase64(Boolean)Instructs the XmlReader to read the string value at its current position and return it as a base-64 byte array.
Protected methodStatic memberToByteArrayBase64(String)Produces a base-64 byte array from an input string.
Protected methodToByteArrayHex(Boolean)Instructs the XmlReader to read the string value at its current position and return it as a hexadecimal byte array.
Protected methodStatic memberToByteArrayHex(String)Produces a hexadecimal byte array from an input string.
Protected methodStatic memberToCharProduces a Char object from an input string.
Protected methodStatic memberToDateProduces a DateTime object from an input string.
Protected methodStatic memberToDateTimeProduces a DateTime object from an input string.
Protected methodStatic memberToEnumProduces a numeric enumeration value from a string that consists of delimited identifiers that represent constants from the enumerator list.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Protected methodStatic memberToTimeProduces a DateTime from a string that represents the time.
Protected methodStatic memberToXmlNameDecodes an XML name.
Protected methodStatic memberToXmlNCNameDecodes an XML name.
Protected methodStatic memberToXmlNmTokenDecodes an XML name.
Protected methodStatic memberToXmlNmTokensDecodes an XML name.
Protected methodToXmlQualifiedNameObtains an XmlQualifiedName from a name that may contain a prefix.
Protected methodUnknownAttribute(Object, XmlAttribute)Raises an UnknownAttribute event for the current position of the XmlReader.
Protected methodUnknownAttribute(Object, XmlAttribute, String)Raises an UnknownAttribute event for the current position of the XmlReader.
Protected methodUnknownElement(Object, XmlElement)Raises an UnknownElement event for the current position of the XmlReader.
Protected methodUnknownElement(Object, XmlElement, String)Raises an UnknownElement event for the current position of the XmlReader.
Protected methodUnknownNode(Object)Raises an UnknownNode event for the current position of the XmlReader.
Protected methodUnknownNode(Object, String)Raises an UnknownNode event for the current position of the XmlReader.
Protected methodUnreferencedObjectInfrastructure. Raises an UnreferencedObject event for the current position of the XmlReader.
Top

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.

.NET Framework

Supported in: 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 Phone 8.1, Windows Phone 8, 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.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.