• Article

XmlDictionaryWriter Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

An abstract class that Silverlight 5 derives from to do serialization and deserialization.

Inheritance Hierarchy

System.Object
  System.Xml.XmlWriter
    System.Xml.XmlDictionaryWriter

Namespace:  System.Xml
Assembly:  System.Runtime.Serialization (in System.Runtime.Serialization.dll)

Syntax

'Declaration
Public MustInherit Class XmlDictionaryWriter _
    Inherits XmlWriter

public abstract class XmlDictionaryWriter : XmlWriter

The XmlDictionaryWriter type exposes the following members.

Constructors

  Name Description
Protected methodSupported by Silverlight for Windows Phone XmlDictionaryWriter Creates an instance of this class. Invoked only by its derived classes because this class is abstract.

Top

Properties

  Name Description
Public propertySupported by Silverlight for Windows Phone CanCanonicalize This property always returns false. Its derived classes can override to return true if they support canonicalization.
Public propertySupported by Silverlight for Windows Phone Settings Gets the XmlWriterSettings object used to create this XmlWriter instance. (Inherited from XmlWriter.)
Public propertySupported by Silverlight for Windows Phone WriteState When overridden in a derived class, gets the state of the writer. (Inherited from XmlWriter.)
Public propertySupported by Silverlight for Windows Phone XmlLang When overridden in a derived class, gets the current xml:lang scope. (Inherited from XmlWriter.)
Public propertySupported by Silverlight for Windows Phone XmlSpace When overridden in a derived class, gets an XmlSpace representing the current xml:space scope. (Inherited from XmlWriter.)

Top

Methods

  Name Description
Public methodSupported by Silverlight for Windows Phone Close When overridden in a derived class, closes this stream and the underlying stream. (Inherited from XmlWriter.)
Public methodStatic memberSupported by Silverlight for Windows Phone CreateBinaryWriter(Stream) Creates an instance of XmlDictionaryWriter that writes Silverlight binary XML format.
Public methodStatic memberSupported by Silverlight for Windows Phone CreateBinaryWriter(Stream, IXmlDictionary) Creates an instance of XmlDictionaryWriter that writes Silverlight binary XML format.
Public methodStatic memberSupported by Silverlight for Windows Phone CreateBinaryWriter(Stream, IXmlDictionary, XmlBinaryWriterSession) Creates an instance of XmlDictionaryWriter that writes Silverlight binary XML format.
Public methodStatic memberSupported by Silverlight for Windows Phone CreateBinaryWriter(Stream, IXmlDictionary, XmlBinaryWriterSession, Boolean) Creates an instance of XmlDictionaryWriter that writes Silverlight binary XML format.
Public methodStatic memberSupported by Silverlight for Windows Phone CreateDictionaryWriter Creates an instance of XmlDictionaryWriter from an existing XmlWriter.
Public methodStatic member CreateTextWriter(Stream) Creates an instance of XmlDictionaryWriter that writes text XML.
Public methodStatic member CreateTextWriter(Stream, Encoding) Creates an instance of XmlDictionaryWriter that writes text XML.
Public methodStatic member CreateTextWriter(Stream, Encoding, Boolean) Creates an instance of XmlDictionaryWriter that writes text XML.
Public methodSupported by Silverlight for Windows Phone Dispose() (Inherited from XmlWriter.)
Protected methodSupported by Silverlight for Windows Phone Dispose(Boolean) Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone EndCanonicalization This method is not yet implemented.
Public methodSupported by Silverlight for Windows Phone Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone Flush When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetType Gets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone LookupPrefix When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI. (Inherited from XmlWriter.)
Protected methodSupported by Silverlight for Windows Phone MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone StartCanonicalization This method is not yet implemented. Calling it throws a NotSupportedException.
Public methodSupported by Silverlight for Windows Phone ToString Returns a string that represents the current object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Boolean[], Int32, Int32) Writes values from a Boolean array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<DateTime[], Int32, Int32) Writes nodes from a DateTime array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Decimal[], Int32, Int32) Writes nodes from a Decimal array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Double[], Int32, Int32) Writes nodes from a Double array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Guid[], Int32, Int32) Writes nodes from a Guid array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Int16[], Int32, Int32) Writes nodes from a Int16 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Int32[], Int32, Int32) Writes nodes from a Int32 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Int64[], Int32, Int32) Writes nodes from a Int64 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<Single[], Int32, Int32) Writes nodes from a Single array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, String, String, array<TimeSpan[], Int32, Int32) Writes nodes from a TimeSpan array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Boolean[], Int32, Int32) Writes nodes from a Boolean array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<DateTime[], Int32, Int32) Writes nodes from a DateTime array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Decimal[], Int32, Int32) Writes nodes from a Decimal array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Double[], Int32, Int32) Writes nodes from a Double array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Guid[], Int32, Int32) Writes nodes from a Guid array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Int16[], Int32, Int32) Writes nodes from a Int16 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Int32[], Int32, Int32) Writes nodes from a Int32 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Int64[], Int32, Int32) Writes nodes from a Int64 array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<Single[], Int32, Int32) Writes nodes from a Single array.
Public methodSupported by Silverlight for Windows Phone WriteArray(String, XmlDictionaryString, XmlDictionaryString, array<TimeSpan[], Int32, Int32) Writes nodes from a TimeSpan array.
Public methodSupported by Silverlight for Windows Phone WriteAttributes When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteAttributeString(String, String) When overridden in a derived class, writes out the attribute with the specified local name and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteAttributeString(String, String, String) When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteAttributeString(XmlDictionaryString, XmlDictionaryString, String) Writes an attribute qualified name and value.
Public methodSupported by Silverlight for Windows Phone WriteAttributeString(String, XmlDictionaryString, XmlDictionaryString, String) Writes an attribute qualified name and value.
Public methodSupported by Silverlight for Windows Phone WriteAttributeString(String, String, String, String) When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteBase64 When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteBinHex When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteCData When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteCharEntity When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteChars When overridden in a derived class, writes text one buffer at a time. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteComment When overridden in a derived class, writes out a comment <!--...--> containing the specified text. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteDocType When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteElementString(String, String) When overridden in a derived class, writes an element with the specified local name and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteElementString(String, String, String) When overridden in a derived class, writes an element with the specified local name, namespace URI, and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteElementString(XmlDictionaryString, XmlDictionaryString, String) Writes an element with a text content.
Public methodSupported by Silverlight for Windows Phone WriteElementString(String, XmlDictionaryString, XmlDictionaryString, String) Writes an element with a text content.
Public methodSupported by Silverlight for Windows Phone WriteElementString(String, String, String, String) Writes an element with the specified local name, namespace URI, and value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteEndAttribute When overridden in a derived class, closes the previous WriteStartAttribute call. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteEndDocument When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteEndElement When overridden in a derived class, closes one element and pops the corresponding namespace scope. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteEntityRef When overridden in a derived class, writes out an entity reference as &name;. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteFullEndElement When overridden in a derived class, closes one element and pops the corresponding namespace scope. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteName When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteNmToken When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteNode(XmlDictionaryReader, Boolean) Writes the current XML node from an XmlDictionaryReader.
Public methodSupported by Silverlight for Windows Phone WriteNode(XmlReader, Boolean) Writes the current XML node from an XmlReader. (Overrides XmlWriter.WriteNode(XmlReader, Boolean).)
Public methodSupported by Silverlight for Windows Phone WriteProcessingInstruction When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteQualifiedName(String, String) When overridden in a derived class, writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteQualifiedName(XmlDictionaryString, XmlDictionaryString) Writes the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace.
Public methodSupported by Silverlight for Windows Phone WriteRaw(String) When overridden in a derived class, writes raw markup manually from a string. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteRaw(array<Char[], Int32, Int32) When overridden in a derived class, writes raw markup manually from a character buffer. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartAttribute(String) Writes the start of an attribute with the specified local name. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartAttribute(String, String) Writes the start of an attribute with the specified local name and namespace URI. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartAttribute(XmlDictionaryString, XmlDictionaryString) Writes the start of an attribute with the specified local name and namespace URI.
Public methodSupported by Silverlight for Windows Phone WriteStartAttribute(String, XmlDictionaryString, XmlDictionaryString) Writes the start of an attribute with the specified prefix, local name, and namespace URI.
Public methodSupported by Silverlight for Windows Phone WriteStartAttribute(String, String, String) When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartDocument() When overridden in a derived class, writes the XML declaration with the version "1.0". (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartDocument(Boolean) When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartElement(String) When overridden in a derived class, writes out a start tag with the specified local name. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartElement(String, String) When overridden in a derived class, writes the specified start tag and associates it with the given namespace. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteStartElement(XmlDictionaryString, XmlDictionaryString) Writes the specified start element and associates it with the given namespace.
Public methodSupported by Silverlight for Windows Phone WriteStartElement(String, XmlDictionaryString, XmlDictionaryString) Writes the specified start element and associates it with the given namespace and prefix.
Public methodSupported by Silverlight for Windows Phone WriteStartElement(String, String, String) When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteString(String) When overridden in a derived class, writes the given text content. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteString(XmlDictionaryString) Writes the given text content.
Public methodSupported by Silverlight for Windows Phone WriteSurrogateCharEntity When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair. (Inherited from XmlWriter.)
Protected methodSupported by Silverlight for Windows Phone WriteTextNode Writes the text node that an XmlDictionaryReader is currently positioned on.
Public methodSupported by Silverlight for Windows Phone WriteValue(Boolean) Writes a Boolean value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(DateTime) Writes a DateTime value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(Decimal) Writes a Decimal value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(Double) Writes a Double value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(Guid) Writes a Guid value.
Public methodSupported by Silverlight for Windows Phone WriteValue(Int32) Writes a Int32 value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(Int64) Writes a Int64 value. (Inherited from XmlWriter.)
Public method WriteValue(IStreamProvider) Writes a value from an IStreamProvider.
Public methodSupported by Silverlight for Windows Phone WriteValue(Object) Writes the object value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(Single) Writes a single-precision floating-point number. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(String) Writes a String value. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteValue(TimeSpan) Writes a TimeSpan value.
Public methodSupported by Silverlight for Windows Phone WriteValue(UniqueId) Writes a unique ID value.
Public methodSupported by Silverlight for Windows Phone WriteValue(XmlDictionaryString) Writes a XmlDictionaryString value.
Public methodSupported by Silverlight for Windows Phone WriteWhitespace When overridden in a derived class, writes out the given white space. (Inherited from XmlWriter.)
Public methodSupported by Silverlight for Windows Phone WriteXmlAttribute(String, String) Writes a standard XML attribute in the current node.
Public methodSupported by Silverlight for Windows Phone WriteXmlAttribute(XmlDictionaryString, XmlDictionaryString) Writes an XML attribute in the current node.
Public methodSupported by Silverlight for Windows Phone WriteXmlnsAttribute(String, String) Writes a namespace declaration attribute.
Public methodSupported by Silverlight for Windows Phone WriteXmlnsAttribute(String, XmlDictionaryString) Writes a namespace declaration attribute.

Top

Remarks

You can derive from this class to do other functions than serialization.

NoteNote:

There is a known issue with the normalization of linefeed characters inside CDATA sections that you might encounter.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

System.Xml Namespace