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 shodná s sémantikou Merge(DataSet) operace. Stejně jako u operace se Merge(DataSet)RowState hodnoty zachovají. Vstup do ReadXml(XmlReader) pomocí 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 diffGram, na kterém WriteXml je volána hodnota DiffGram. Jinak operace sloučení DiffGram selže a vyvolá se výjimka.

Fragment 5

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

IgnoreSchema 2

Ignoruje jakékoli vložené schéma a čte data do existujícího DataSet schématu. Pokud některá data neodpovídají existujícímu schématu, budou zahozena (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 se vyvolá, pokud odvozená tabulka již existuje, ale má jiný obor 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í z dat schéma silného typu a načte data. Pokud typ nelze z dat odvodit, 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 se vyvolá, pokud odvozená tabulka již existuje, ale má jiný obor 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 pokud již nějaké tabulky ve vloženého schématu v systému existují, dojde k výjimceDataSet.

Poznámky

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

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 ReadSchemahodnotu .

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

Platí pro