XmlReadMode Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 |
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, |
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
.