XmlReadMode Enumeráció

Definíció

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
XmlReadMode

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, IgnoreSchema mint a DiffGram.

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 Fragment, a rendszer az alapértelmezett névteret beágyazott sémaként olvassa be.

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

A következőre érvényes: