XmlReadMode Výčet

Definice

Určuje, jak číst data XML a relační schéma do objektu DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Dědičnost
XmlReadMode

Pole

Auto 0

Výchozí režim čtení.

DiffGram 4

Načte DiffGram a použije změny z diffGramu na DataSet. Sémantika je stejná jako Merge(DataSet) u operace. Stejně jako u Merge(DataSet) operace se RowState hodnoty zachovají. Vstup do ReadXml(XmlReader) s diffGrams by měl být získán pouze pomocí výstupu z WriteXml(Stream) jako DiffGram.

Cíl DataSet musí mít stejné schéma jako , DataSet na kterém WriteXml je volána diffGram. V opačném případě se operace sloučení DiffGram nezdaří a vyvolá se výjimka.

Fragment 5

Čte fragmenty XML, například ty, které se generují spuštěním dotazů FOR XML, na instanci SQL Server. Pokud XmlReadMode je nastavená hodnota Fragment, výchozí obor názvů se přečte jako vložené schéma.

IgnoreSchema 2

Ignoruje všechna vložená schémata a načte data do existujícího DataSet schématu. Pokud některá data neodpovídají existujícímu schématu, zahodí se (včetně dat z různých oborů názvů definovaných pro DataSet). Pokud jsou data DiffGram, IgnoreSchema mají stejné funkce jako DiffGram.

InferSchema 3

Ignoruje jakékoli vložené schéma, odvodí schéma z dat a načte data. DataSet Pokud už schéma obsahuje, aktuální schéma se rozšíří přidáním nových tabulek nebo přidáním sloupců do existujících tabulek. Výjimka je vyvolán, pokud odvozená tabulka již existuje, ale s jiným oborem názvů, nebo pokud některý z odvozených sloupců koliduje s existujícími sloupci.

InferTypedSchema 6

Ignoruje jakékoli vložené schéma, odvodí schéma silného typu z dat a načte data. Pokud typ nelze odvodit z dat, je interpretován jako řetězcová data. DataSet Pokud už schéma obsahuje, aktuální schéma se rozšíří přidáním nových tabulek nebo přidáním sloupců do existujících tabulek. Výjimka je vyvolán, pokud odvozená tabulka již existuje, ale s jiným oborem názvů, nebo pokud některý z odvozených sloupců koliduje s existujícími sloupci.

ReadSchema 1

Přečte jakékoli vložené schéma a načte data. DataSet Pokud již obsahuje schéma, mohou být do schématu přidány nové tabulky, ale je vyvolán výjimka, pokud některé tabulky ve vloženého schématu již existují v objektu DataSet.

Poznámky

Členy tohoto výčtu použijte při nastavování ReadMode parametru DataSet.ReadXml metody .

Poznámka

Auto režim může být pomalejší než nastavení XmlReadMode explicitní možnosti.

Auto provede nejvhodnější z těchto akcí:

  • Pokud jsou data DiffGram, nastaví režim čtení XML na DiffGram.

  • Pokud už datová sada schéma obsahuje nebo pokud dokument obsahuje vložené schéma, nastaví režim čtení XML na ReadSchema.

  • Pokud datová sada ještě nemá schéma a dokument neobsahuje vložené schéma, nastaví režim čtení XML na InferSchema.

Platí pro