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 DataSet.
public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode =
Public Enum XmlReadMode
- Dědičnost
Pole
| Name | Hodnota | Description |
|---|---|---|
| Auto | 0 | Výchozí režim čtení. |
| ReadSchema | 1 | Nač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é schématu již existují v objektu DataSet. |
| 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 dané DataSetschéma). Pokud jsou data DiffGram, |
| InferSchema | 3 | Ignoruje všechna vložená schémata, odvozuje schéma z dat a načte data. DataSet Pokud již 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 s jiným oborem názvů nebo pokud některý z odvozených sloupců koliduje s existujícími sloupci. |
| DiffGram | 4 | Přečte DiffGram a použije změny z diffGramu na DataSetobjektu . Sémantika je shodná s Merge(DataSet) sémantikou operace. Stejně jako u Merge(DataSet) operace RowState se hodnoty zachovají. Vstup do ReadXml(XmlReader) diffGramů by měl být získán pouze pomocí výstupu z WriteXml(Stream) diffGramu. Cíl DataSet musí mít stejné schéma jako diffGram DataSetWriteXml . Jinak se operace sloučení DiffGram nezdaří a vyvolá se výjimka. |
| Fragment | 5 | Čte fragmenty XML, například fragmenty vygenerované spuštěním dotazů FOR XML na instanci SQL Server. Pokud XmlReadMode je nastavena na |
| InferTypedSchema | 6 | Ignoruje jakékoli vložené schéma, odvodí ze dat schéma silného typu a načte data. Pokud typ nelze odvodit z dat, interpretuje se jako řetězcová data. DataSet Pokud již schéma obsahuje, aktuální schéma se rozšíří buď 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 s jiným oborem názvů nebo pokud některý z odvozených sloupců koliduje s existujícími sloupci. |
Poznámky
Při nastavování ReadMode parametru metody použijte členy tohoto výčtu DataSet.ReadXml .
Note
Auto režim může být pomalejší než nastavení XmlReadMode explicitní možnosti.
Auto provádí nejvhodnější z těchto akcí:
Pokud jsou data DiffGram, nastaví režim čtení XML na
DiffGram.Pokud datová sada již obsahuje schéma 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.