XmlReadMode Enumeráció
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Megadja, hogyan olvashatja be az XML-adatokat és a relációs sémát egy DataSet.
public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode =
Public Enum XmlReadMode
- Öröklődés
Mezők
| Name | Érték | Description |
|---|---|---|
| Auto | 0 | Az alapértelmezett olvasási mód. |
| ReadSchema | 1 | Beolvassa a beágyazott sémákat, és betölti az adatokat. Ha a DataSet rendszer már tartalmaz sémát, új táblákat adhat hozzá a sémához, de kivételt jelent, ha a beágyazott sémában lévő táblák már léteznek a DataSetsémában. |
| IgnoreSchema | 2 | Figyelmen kívül hagyja a beágyazott sémákat, és beolvassa az adatokat a meglévő DataSet sémába. Ha bármely adat nem egyezik a meglévő sémával, a rendszer elveti az adatokat (beleértve a DataSetkülönböző névterekhez definiált adatokat is). Ha az adat egy DiffGram, ugyanazzal a funkcióval rendelkezik, |
| InferSchema | 3 | Figyelmen kívül hagy minden beágyazott sémát, a sémát az adatokból következteti, és betölti az adatokat. Ha a DataSet séma már tartalmaz egy sémát, az aktuális séma kiterjeszthető új táblák hozzáadásával vagy oszlopok meglévő táblákhoz való hozzáadásával. Kivétel akkor keletkezik, ha a kikövetkeztetett tábla már létezik, de más névtérrel rendelkezik, vagy ha a kikövetkeztetett oszlopok bármelyike ütközik a meglévő oszlopokkal. |
| DiffGram | 4 | Beolvassa a DiffGramot, és a DiffGram módosításait alkalmazza a DataSet. A szemantikák megegyeznek a Merge(DataSet) műveletekkel. A művelethez Merge(DataSet) hasonlóan az RowState értékek is megmaradnak. A DiffGrams bemenetét ReadXml(XmlReader) csak DiffGram-ként kapott kimenettel WriteXml(Stream) szabad beszerezni. A célnak DataSet ugyanazzal a sémával kell rendelkeznie, mint DataSet a WriteXml DiffGram meghívásának. Ellenkező esetben a DiffGram egyesítési művelete meghiúsul, és kivétel lép fel. |
| Fragment | 5 | Beolvassa az XML-töredékeket, például azOKAT, amelyek a FOR XML-lekérdezések végrehajtásával jönnek létre a SQL Server egy példányán. Ha XmlReadMode be van állítva |
| InferTypedSchema | 6 | Figyelmen kívül hagy minden beágyazott sémát, egy erősen beírt sémát következtet az adatokból, és betölti az adatokat. Ha a típus nem vonható le az adatokból, a rendszer sztringadatokként értelmezi. Ha a DataSet séma már tartalmaz egy sémát, az aktuális séma ki lesz terjesztve új táblák hozzáadásával vagy oszlopokkal a meglévő táblákhoz való hozzáadásával. Kivétel akkor keletkezik, ha a kikövetkeztetett tábla már létezik, de más névtérrel rendelkezik, vagy ha a kikövetkeztetett oszlopok bármelyike ütközik a meglévő oszlopokkal. |
Megjegyzések
A metódus paraméterének beállításakor ReadMode használja az enumerálás tagjait DataSet.ReadXml .
Note
Auto a mód lassabb lehet, mint XmlReadMode egy explicit beállítás beállítása.
Auto az alábbi műveletek közül a legmegfelelőbbet hajtja végre:
Ha az adatok DiffGram formátumúak, az XML olvasási módját a következőre
DiffGramállítja be: .Ha az adatkészlet már rendelkezik sémával, vagy ha a dokumentum tartalmaz egy soron belüli sémát, az XML olvasási módját a következőre
ReadSchemaállítja be: .Ha az adathalmaz még nem rendelkezik sémával, és a dokumentum nem tartalmaz soron belüli sémát, az XML olvasási módját a következőre
InferSchemaállítja be: .