XmlReadMode Enumeration (System.Data)

Switch View

XmlReadMode Enumeration

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

XmlReadMode Enumeration

Specifies how to read XML data and a relational schema into a DataSet.

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

Syntax

Visual Basic (Declaration)

Public Enumeration XmlReadMode

Visual Basic (Usage)

Dim instance As XmlReadMode

public enum XmlReadMode

Visual C++

public enum class XmlReadMode

JScript

public enum XmlReadMode

Members

	Member name	Description
	Auto	Default. Performs the most appropriate of these actions: If the data is a DiffGram, sets XmlReadMode to DiffGram. -or- If the dataset already has a schema, or the document contains an in-line schema, sets XmlReadMode to ReadSchema. -or- If the dataset does not already have a schema and the document does not contain an in-line schema, sets XmlReadMode to InferSchema.
	ReadSchema	Reads any inline schema and loads the data. If the DataSet already contains schema, new tables may be added to the schema, but an exception is thrown if any tables in the inline schema already exist in the DataSet.
	IgnoreSchema	Ignores any inline schema and reads data into the existing DataSet schema. If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.
	InferSchema	Ignores any inline schema, infers schema from the data and loads the data. If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.
	DiffGram	Reads a DiffGram, applying changes from the DiffGram to the DataSet. The semantics are identical to those of a Merge operation. As with the Merge operation, RowState values are preserved. Input to ReadXml with DiffGrams should only be obtained using the output from WriteXml as a DiffGram. The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. Otherwise the DiffGram merge operation fails, and an exception is thrown.
	Fragment	Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.
	InferTypedSchema	Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. If the type cannot be inferred from the data, it is interpreted as string data. If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

Remarks

Use the members of this enumeration when setting the ReadMode parameter of the ReadXml method.

Note:
Auto mode may be slower than setting XmlReadMode to an explicit option.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

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

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

System.Data Namespace