XmlReadMode Enumeration

Definition

Namespace:

System.Data

Assembly:

System.Data.dll

Gibt an, wie XML-Daten und ein relationales Schema in einem DataSetgelesen werden.

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

Vererbung

Object

ValueType

Enum

XmlReadMode

Felder

Name	Wert	Beschreibung
Auto	0	Der Standardlesemodus.
ReadSchema	1	Liest ein beliebiges Inlineschema und lädt die Daten. Wenn das DataSet bereits vorhandene Schema enthält, werden dem Schema möglicherweise neue Tabellen hinzugefügt, es wird jedoch eine Ausnahme ausgelöst, wenn tabellen im Inlineschema bereits in der DataSetDatei vorhanden sind.
IgnoreSchema	2	Ignoriert alle Inlineschemas und liest Daten in das vorhandene DataSet Schema. Wenn daten nicht mit dem vorhandenen Schema übereinstimmen, wird sie verworfen (einschließlich Daten von unterschiedlichen Namespaces, die für das DataSet). Wenn es sich bei den Daten um ein DiffGram handelt, IgnoreSchema hat die gleiche Funktionalität wie DiffGram.
InferSchema	3	Ignoriert alle Inlineschemas, leitet das Schema aus den Daten ab und lädt die Daten. Wenn das DataSet bereits ein Schema enthält, wird das aktuelle Schema durch Hinzufügen neuer Tabellen oder Hinzufügen von Spalten zu vorhandenen Tabellen erweitert. Eine Ausnahme wird ausgelöst, wenn die abgeleitete Tabelle bereits vorhanden ist, jedoch mit einem anderen Namespace oder wenn eine der abgeleiteten Spalten mit vorhandenen Spalten in Konflikt steht.
DiffGram	4	Liest ein DiffGram, und wendet Änderungen vom DiffGram auf die DataSet. Die Semantik ist identisch mit denen eines Merge(DataSet) Vorgangs. Wie bei dem Merge(DataSet) Vorgang RowState werden Werte beibehalten. Eingaben für ReadXml(XmlReader) DiffGrams sollten nur mithilfe der Ausgabe als WriteXml(Stream) DiffGram abgerufen werden. Das Ziel DataSet muss dasselbe Schema wie das DataSet Schema aufweisen, für das WriteXml DiffGram aufgerufen wird. Andernfalls schlägt der DiffGram-Zusammenführungsvorgang fehl, und eine Ausnahme wird ausgelöst.
Fragment	5	Liest XML-Fragmente, z. B. durch Ausführen von FOR XML-Abfragen, anhand einer Instanz von SQL Server. Wenn XmlReadMode dieser auf festgelegt Fragmentist, wird der Standardnamespace als Inlineschema gelesen.
InferTypedSchema	6	Ignoriert alle Inlineschemas, leitet ein stark typiertes Schema aus den Daten ab und lädt die Daten. Wenn der Typ nicht von den Daten abgeleitet werden kann, wird er als Zeichenfolgendaten interpretiert. Wenn das DataSet bereits ein Schema enthält, wird das aktuelle Schema erweitert, entweder durch Hinzufügen neuer Tabellen oder durch Hinzufügen von Spalten zu vorhandenen Tabellen. Eine Ausnahme wird ausgelöst, wenn die abgeleitete Tabelle bereits vorhanden ist, jedoch mit einem anderen Namespace oder wenn eine der abgeleiteten Spalten mit vorhandenen Spalten in Konflikt steht.

Hinweise

Verwenden Sie die Member dieser Enumeration, wenn Sie den ReadMode Parameter der DataSet.ReadXml Methode festlegen.

Note

Auto der Modus kann langsamer als die Einstellung XmlReadMode auf eine explizite Option sein.

Auto führt die am besten geeigneten Aktionen aus:

• Wenn es sich bei den Daten um ein DiffGram handelt, wird der XML-Lesemodus auf DiffGram.

• Wenn das Dataset bereits über ein Schema verfügt oder wenn das Dokument ein inlinees Schema enthält, wird der XML-Lesemodus auf ReadSchema festgelegt.

• Wenn das Dataset noch nicht über ein Schema verfügt und das Dokument kein inlinees Schema enthält, legt den XML-Lesemodus auf InferSchema.