XmlReadMode XmlReadMode XmlReadMode XmlReadMode Enum

Definition

Gibt an, wie XML-Daten und ein relationales Schema in ein DataSet eingelesen werden sollen.Specifies how to read XML data and a relational schema into a DataSet.

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

Felder

Auto Auto Auto Auto 0

Der Standardlesemodus.The default read mode.

DiffGram DiffGram DiffGram DiffGram 4

Liest ein DiffGram, wobei die Änderungen aus dem DiffGram auf das DataSet-Objekt angewendet werden.Reads a DiffGram, applying changes from the DiffGram to the DataSet. Die Semantik ist identisch mit der einer Merge(DataSet)-Operation.The semantics are identical to those of a Merge(DataSet) operation. Wie bei der Merge(DataSet)-Operation werden die RowState-Werte beibehalten.As with the Merge(DataSet) operation, RowState values are preserved. Die Eingabe in ReadXml(XmlReader) mit DiffGrams sollte nur unter Verwendung der Ausgabe von WriteXml(Stream) als DiffGram abgerufen werden.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

Das Ziel DataSet muss das gleiche Schema wie das DataSet haben, auf dem WriteXml als DiffGram aufgerufen wird.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. Andernfalls tritt bei dem DiffGram-Zusammenführungsvorgang ein Fehler auf, und eine Ausnahme wird ausgelöst.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment Fragment Fragment 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.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Wenn XmlReadMode auf Fragment festgelegt ist, wird der Standardnamespace als Inlineschema gelesen.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema IgnoreSchema IgnoreSchema IgnoreSchema 2

Ignoriert alle Inlineschemata und liest Daten in das vorhandene DataSet-Schema ein.Ignores any inline schema and reads data into the existing 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).If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Wenn es sich bei den Daten um ein DiffGram handelt, hat IgnoreSchema dieselbe Funktion wie DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema InferSchema InferSchema InferSchema 3

Ignoriert alle Inlineschemas, leitet das Schema von den Daten her und lädt die Daten.Ignores any inline schema, infers schema from the data and loads the data. Wenn das DataSet bereits ein Schema enthält, wird das aktuelle Schema durch Hinzufügen neuer Tabellen oder neuer Spalten zu vorhandenen Tabellen erweitert.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. 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.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.

InferTypedSchema InferTypedSchema InferTypedSchema InferTypedSchema 6

Ignoriert alle Inlineschemas, leitet ein Schema mit starker Typisierung von den Daten her und lädt die Daten.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. Wenn der Typ nicht von den Daten abgeleitet werden kann, wird die Daten als Zeichenfolgendaten interpretiert.If the type cannot be inferred from the data, it is interpreted as string data. 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.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. 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.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.

ReadSchema ReadSchema ReadSchema ReadSchema 1

Liest jedes Inlineschema und lädt die Daten.Reads any inline schema and loads the data. 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.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.

Hinweise

Verwenden Sie die Member dieser Enumeration, wenn Sie ReadMode den-Parameter DataSet.ReadXml der-Methode festlegen.Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Hinweis

Autoder Modus ist möglicherweise langsamer XmlReadMode als das Festlegen einer expliziten Option.Auto mode may be slower than setting XmlReadMode to an explicit option.

Autoführt die am besten geeigneten Aktionen aus:Auto performs the most appropriate of these actions:

  • Wenn es sich bei den Daten um ein DiffGram-Format handelt, DiffGramlegt den XML-Lesemodus auf festIf the data is a DiffGram, sets the XML read mode to DiffGram.

  • Wenn das DataSet bereits über ein Schema verfügt oder wenn das Dokument ein Inline Schema enthält, legt den XML-Lesemodus auf ReadSchemafest.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • Wenn das DataSet nicht bereits über ein Schema verfügt und das Dokument kein Inline Schema enthält, legt den XML-Lesemodus auf InferSchemafest.If the dataset does not already have a schema and the document does not contain an in-line schema, sets the XML read mode to InferSchema.

Gilt für: