XmlReadMode-Enumeration

Gibt an, wie XML-Daten und ein relationales Schema in ein DataSet eingelesen werden sollen.

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

Syntax

'Declaration
Public Enumeration XmlReadMode
'Usage
Dim instance As XmlReadMode

public enum XmlReadMode

public enum class XmlReadMode

public enum XmlReadMode

public enum XmlReadMode

Member

	Membername	Beschreibung
	Auto	Standardeinstellung.   Führt die am besten geeignete dieser Aktionen aus: Legt XmlReadMode auf DiffGram fest, wenn es sich bei den Daten um ein DiffGram handelt. - oder - Legt XmlReadMode auf ReadSchema fest, wenn das Dataset bereits über ein Schema verfügt oder das Dokument ein Inlineschema enthält. - oder - Legt XmlReadMode auf InferSchema fest, wenn das Dataset noch kein Schema aufweist und das Dokument kein Inlineschema enthält.
	DiffGram	Liest ein DiffGram, wobei die Änderungen aus dem DiffGram auf das DataSet-Objekt angewendet werden. Die Semantik ist identisch mit der einer Merge-Operation. Wie bei der Merge-Operation werden die RowState-Werte beibehalten. Die Eingabe in ReadXml mit DiffGrams sollte nur unter Verwendung der Ausgabe von WriteXml als DiffGram abgerufen werden.  Das Ziel-DataSet-Objekt muss über dasselbe Schema wie das DataSet-Objekt verfügen, für das WriteXml als DiffGram aufgerufen wird. Andernfalls schlägt die DiffGram-Zusammenführung fehl, und eine Ausnahme wird ausgelöst.
	Fragment	Liest XML-Fragmente, z. B. solche, die durch Ausführen von FOR XML-Abfragen generiert werden, für eine Instanz von SQL Server. Wenn XmlReadMode auf Fragment festgelegt ist, wird der Standardnamespace als Inlineschema gelesen.
	IgnoreSchema	Ignoriert alle Inlineschemas und liest Daten in das vorhandene DataSet-Schema. Wenn Daten nicht dem vorhandenen Schema entsprechen, werden sie verworfen (auch die Daten aus anderen Namespaces, die für das DataSet definiert wurden). Wenn es sich bei den Daten um ein DiffGram handelt, hat IgnoreSchema dieselbe Funktion wie DiffGram.
	InferSchema	Ignoriert alle Inlineschemas, leitet das Schema von den Daten her und lädt die Daten. Wenn das DataSet bereits ein Schema enthält, wird das aktuelle Schema durch Hinzufügen neuer Tabellen oder neuer Spalten zu vorhandenen Tabellen erweitert. Eine Ausnahme wird ausgelöst, wenn die hergeleitete Tabelle bereits mit einem anderen Namespace vorhanden ist, oder wenn bei hergeleiteten Spalten ein Konflikt mit vorhandenen Spalten auftritt.
	InferTypedSchema	Ignoriert alle Inlineschemas, leitet ein Schema mit starker Typisierung von den Daten her und lädt die Daten. Wenn der Typ nicht von den Daten abgeleitet werden kann, wird die Daten als Zeichenfolgendaten interpretiert. Wenn das DataSet bereits ein Schema enthält, wird das aktuelle Schema entweder durch Hinzufügen neuer Tabellen oder durch Hinzufügen neuer Spalten zu vorhandenen Tabellen erweitert. Eine Ausnahme wird ausgelöst, wenn die hergeleitete Tabelle bereits mit einem anderen Namespace vorhanden ist, oder wenn bei hergeleiteten Spalten ein Konflikt mit vorhandenen Spalten auftritt.
	ReadSchema	Liest jedes Inlineschema und lädt die Daten. Wenn das DataSet bereits ein Schema enthält, können diesem evtl. neue Tabellen hinzugefügt werden. Es wird jedoch eine Ausnahme ausgelöst, wenn Tabellen im Inlineschema bereits im DataSet vorhanden sind.

Hinweise

Verwenden Sie die Member dieser Enumeration für das Festlegen des ReadMode-Parameters der ReadXml-Methode.

Hinweis

Der Auto-Modus ist u. U. langsamer als das Festlegen von XmlReadMode auf eine bestimmte Option.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

System.Data-Namespace