Was this page helpful?
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XmlWriter.WriteValue Method (Object)


Writes the object value.

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

public virtual void WriteValue(
	object value


Type: System.Object

The object value to write.

Note   With the release of the .NET Framework 3.5, this method accepts DateTimeOffset as a parameter.

Exception Condition

An invalid value was specified.


The value is null.


The writer is closed or in error state.


An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

This method takes the common language runtime (CLR) object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

If the CLR object is a list type such as IEnumerable, IList, or ICollection, it is treated as an array of the value type. The XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft