This topic has not yet been rated - Rate this topic

XmlSerializationWriter Class

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

Abstract class used for controlling serialization by the XmlSerializer class.

System.Object
  System.Xml.Serialization.XmlSerializationGeneratedCode
    System.Xml.Serialization.XmlSerializationWriter

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

The XmlSerializationWriter type exposes the following members.

  Name Description
Protected method XmlSerializationWriter Initializes a new instance of the XmlSerializationWriter class.
Top
  Name Description
Protected property EscapeName Gets or sets a value that indicates whether the EncodeName method is used to write valid XML.
Protected property Namespaces Gets or sets a list of XML qualified name objects that contain the namespaces and prefixes used to produce qualified names in XML documents.
Protected property Writer Gets the XmlWriter that is being used by the XmlSerializationWriter.
Top
  Name Description
Protected method AddWriteCallback Stores an implementation of the XmlSerializationWriteCallback delegate and the type it applies to, for a later invocation.
Protected method CreateChoiceIdentifierValueException Creates an InvalidOperationException that indicates an unexpected name for an element that adheres to an XML Schema choice element declaration.
Protected method CreateInvalidAnyTypeException(Object) Creates an InvalidOperationException that indicates the XmlAnyElementAttribute has been invalidly applied to a member; only members that are of type XmlNode, or derived from XmlNode, are valid.
Protected method CreateInvalidAnyTypeException(Type) Creates an InvalidOperationException that indicates the XmlAnyElementAttribute has been invalidly applied to a member; only members that are of type XmlNode, or derived from XmlNode, are valid.
Protected method CreateInvalidChoiceIdentifierValueException Creates an InvalidOperationException that indicates a failure while writing an array where an XML Schema choice element declaration is applied.
Protected method CreateInvalidEnumValueException Creates an InvalidOperationException for an invalid enumeration value.
Protected method CreateMismatchChoiceException Creates an InvalidOperationException that indicates that a value for an XML element does not match an enumeration type.
Protected method CreateUnknownAnyElementException Creates an InvalidOperationException that indicates that an XML element that should adhere to the XML Schema any element declaration cannot be processed.
Protected method CreateUnknownTypeException(Object) Creates an InvalidOperationException that indicates that a type being serialized is not being used in a valid manner or is unexpectedly encountered.
Protected method CreateUnknownTypeException(Type) Creates an InvalidOperationException that indicates that a type being serialized is not being used in a valid manner or is unexpectedly encountered.
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Protected method Static member FromByteArrayBase64 Processes a base-64 byte array.
Protected method Static member FromByteArrayHex Produces a string from an input hexadecimal byte array.
Protected method Static member FromChar Produces a string from an input Char.
Protected method Static member FromDate Produces a string from a DateTime object.
Protected method Static member FromDateTime Produces a string from an input DateTime.
Protected method Static member FromEnum(Int64, String[], Int64[]) Produces a string that consists of delimited identifiers that represent the enumeration members that have been set.
Protected method Static member FromEnum(Int64, String[], Int64[], String) Takes a numeric enumeration value and the names and constants from the enumerator list for the enumeration and returns a string that consists of delimited identifiers that represent the enumeration members that have been set.
Protected method Static member FromTime Produces a string from a DateTime object.
Protected method Static member FromXmlName Encodes a valid XML name by replacing characters that are not valid with escape sequences.
Protected method Static member FromXmlNCName Encodes a valid XML local name by replacing characters that are not valid with escape sequences.
Protected method Static member FromXmlNmToken Encodes an XML name.
Protected method Static member FromXmlNmTokens Encodes a space-delimited sequence of XML names into a single XML name.
Protected method FromXmlQualifiedName(XmlQualifiedName) Returns an XML qualified name, with invalid characters replaced by escape sequences.
Protected method FromXmlQualifiedName(XmlQualifiedName, Boolean) Produces a string that can be written as an XML qualified name, with invalid characters replaced by escape sequences.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method InitCallbacks Initializes instances of the XmlSerializationWriteCallback delegate to serialize SOAP-encoded XML data.
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method Static member ResolveDynamicAssembly Infrastructure. Gets a dynamically generated assembly by name.
Protected method TopLevelElement Initializes object references only while serializing a SOAP-encoded SOAP message.
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Protected method WriteAttribute(String, Byte[]) Instructs an XmlWriter object to write an XML attribute that has no namespace specified for its name.
Protected method WriteAttribute(String, String) Instructs the XmlWriter to write an XML attribute that has no namespace specified for its name.
Protected method WriteAttribute(String, String, Byte[]) Instructs an XmlWriter object to write an XML attribute.
Protected method WriteAttribute(String, String, String) Writes an XML attribute.
Protected method WriteAttribute(String, String, String, String) Writes an XML attribute where the namespace prefix is provided manually.
Protected method WriteElementEncoded Writes an XML node object within the body of a named XML element.
Protected method WriteElementLiteral Instructs an XmlWriter object to write an XmlNode object within the body of a named XML element.
Protected method WriteElementQualifiedName(String, XmlQualifiedName) Writes an XML element with a specified qualified name in its body.
Protected method WriteElementQualifiedName(String, String, XmlQualifiedName) Writes an XML element with a specified qualified name in its body.
Protected method WriteElementQualifiedName(String, XmlQualifiedName, XmlQualifiedName) Writes an XML element with a specified qualified name in its body.
Protected method WriteElementQualifiedName(String, String, XmlQualifiedName, XmlQualifiedName) Writes an XML element with a specified qualified name in its body.
Protected method WriteElementString(String, String) Writes an XML element with a specified value in its body.
Protected method WriteElementString(String, String, String) Writes an XML element with a specified value in its body.
Protected method WriteElementString(String, String, XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteElementString(String, String, String, XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, Byte[]) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, Byte[], XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String, Byte[]) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String, String) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String, XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String, Byte[], XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteElementStringRaw(String, String, String, XmlQualifiedName) Writes an XML element with a specified value in its body.
Protected method WriteEmptyTag(String) Writes an XML element whose body is empty.
Protected method WriteEmptyTag(String, String) Writes an XML element whose body is empty.
Protected method WriteEndElement() Writes a <closing> element tag.
Protected method WriteEndElement(Object) Writes a closing element tag.
Protected method WriteId Writes an id attribute that appears in a SOAP-encoded multiRef element.
Protected method WriteNamespaceDeclarations Infrastructure. Writes namespace declaration attributes.
Protected method WriteNullableQualifiedNameEncoded Writes an XML element whose body contains a valid XML qualified name. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableQualifiedNameLiteral Writes an XML element whose body contains a valid XML qualified name. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringEncoded Writes an XML element that contains a string as the body. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringEncodedRaw(String, String, Byte[], XmlQualifiedName) Writes a byte array as the body of an XML element. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringEncodedRaw(String, String, String, XmlQualifiedName) Writes an XML element that contains a string as the body. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringLiteral Writes an XML element that contains a string as the body. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringLiteralRaw(String, String, Byte[]) Writes a byte array as the body of an XML element. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullableStringLiteralRaw(String, String, String) Writes an XML element that contains a string as the body. XmlWriter inserts a xsi:nil='true' attribute if the string's value is null.
Protected method WriteNullTagEncoded(String) Writes an XML element with an xsi:nil='true' attribute.
Protected method WriteNullTagEncoded(String, String) Writes an XML element with an xsi:nil='true' attribute.
Protected method WriteNullTagLiteral(String) Writes an XML element with an xsi:nil='true' attribute.
Protected method WriteNullTagLiteral(String, String) Writes an XML element with an xsi:nil='true' attribute.
Protected method WritePotentiallyReferencingElement(String, String, Object) Writes a SOAP message XML element that can contain a reference to a <multiRef> XML element for a given object.
Protected method WritePotentiallyReferencingElement(String, String, Object, Type) Writes a SOAP message XML element that can contain a reference to a <multiRef> XML element for a given object.
Protected method WritePotentiallyReferencingElement(String, String, Object, Type, Boolean) Writes a SOAP message XML element that can contain a reference to a <multiRef> XML element for a given object.
Protected method WritePotentiallyReferencingElement(String, String, Object, Type, Boolean, Boolean) Writes a SOAP message XML element that can contain a reference to a multiRef XML element for a given object.
Protected method WriteReferencedElements Serializes objects into SOAP-encoded multiRef XML elements in a SOAP message.
Protected method WriteReferencingElement(String, String, Object) Writes a SOAP message XML element that contains a reference to a multiRef element for a given object.
Protected method WriteReferencingElement(String, String, Object, Boolean) Writes a SOAP message XML element that contains a reference to a multiRef element for a given object.
Protected method WriteRpcResult Writes a SOAP 1.2 RPC result element with a specified qualified name in its body.
Protected method WriteSerializable(IXmlSerializable, String, String, Boolean) Writes an object that uses custom XML formatting as an XML element.
Protected method WriteSerializable(IXmlSerializable, String, String, Boolean, Boolean) Instructs XmlNode to write an object that uses custom XML formatting as an XML element.
Protected method WriteStartDocument Writes the XML declaration if the writer is positioned at the start of an XML document.
Protected method WriteStartElement(String) Writes an opening element tag, including any attributes.
Protected method WriteStartElement(String, String) Writes an opening element tag, including any attributes.
Protected method WriteStartElement(String, String, Boolean) Writes an opening element tag, including any attributes.
Protected method WriteStartElement(String, String, Object) Writes an opening element tag, including any attributes.
Protected method WriteStartElement(String, String, Object, Boolean) Writes an opening element tag, including any attributes.
Protected method WriteStartElement(String, String, Object, Boolean, XmlSerializerNamespaces) Writes an opening element tag, including any attributes.
Protected method WriteTypedPrimitive Writes an XML element whose text body is a value of a simple XML Schema data type.
Protected method WriteValue(Byte[]) Writes a base-64 byte array.
Protected method WriteValue(String) Writes a specified string.
Protected method WriteXmlAttribute(XmlNode) Writes the specified XmlNode as an XML attribute.
Protected method WriteXmlAttribute(XmlNode, Object) Writes the specified XmlNode object as an XML attribute.
Protected method WriteXsiType Writes an xsi:type attribute for an XML element that is being serialized into a document.
Top

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

You should not derive classes from XmlSerializationWriter. Instead, call the Serialize method.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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)
Community Content Add
Annotations FAQ