Teilen über


XmlReadMode Enumeration

Definition

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

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Vererbung
XmlReadMode

Felder

Auto 0

Der Standardlesemodus.

DiffGram 4

Liest ein DiffGram, wobei die Änderungen aus dem DiffGram auf das DataSet-Objekt angewendet werden. Die Semantik ist identisch mit der einer Merge(DataSet)-Operation. Wie bei der Merge(DataSet)-Operation werden die RowState-Werte beibehalten. Die Eingabe in ReadXml(XmlReader) mit DiffGrams sollte nur unter Verwendung der Ausgabe von WriteXml(Stream) als DiffGram abgerufen werden.

Das Ziel DataSet muss das gleiche Schema wie das DataSet haben, auf dem WriteXml als DiffGram aufgerufen wird. Andernfalls tritt bei dem DiffGram-Zusammenführungsvorgang ein Fehler auf, und eine Ausnahme wird ausgelöst.

Fragment 5

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 2

Ignoriert alle Inlineschemata und liest Daten in das vorhandene DataSet-Schema ein. 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 3

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 6

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 1

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, wenn Sie den ReadMode Parameter der DataSet.ReadXml -Methode festlegen.

Hinweis

Auto der Modus ist möglicherweise langsamer als die Einstellung XmlReadMode auf eine explizite Option.

Auto führt die am besten geeigneten der folgenden Aktionen aus:

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

  • Wenn das Dataset bereits über ein Schema verfügt oder das Dokument ein Inlineschema enthält, legt den XML-Lesemodus auf fest ReadSchema.

  • Wenn das Dataset noch kein Schema aufweist und das Dokument kein Inlineschema enthält, legt den XML-Lesemodus auf fest InferSchema.

Gilt für: