DataSet::WriteXml Method (TextWriter^, XmlWriteMode)

 

Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. To write the schema, set the value for the mode parameter to WriteSchema.

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

public:
void WriteXml(
	TextWriter^ writer,
	XmlWriteMode mode
)

Parameters

writer
Type: System.IO::TextWriter^

A System.IO::TextWriter object used to write the document.

mode
Type: System.Data::XmlWriteMode

One of the XmlWriteMode values.

The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. To write both data and schema, set the mode parameter to WriteSchema.

Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. To read XML data, or both schema and data into the DataSet, use the ReadXml method. To read just the schema, use the ReadXmlSchema method.

System_CAPS_noteNote

An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. The DataSet schema and data are written to disk by invoking the WriteXml method. A second DataSet is created and the ReadXml method is used to fill it with schema and data.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: