XmlReadMode Enum

Definition

Anger hur du läser XML-data och ett relationsschema i en DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Arv
XmlReadMode

Fält

Name Värde Description
Auto 0

Standardläsningsläget.

ReadSchema 1

Läser alla infogade scheman och läser in data. Om schemat DataSet redan innehåller kan nya tabeller läggas till i schemat, men ett undantag utlöses om det redan finns några tabeller i det infogade schemat i DataSet.

IgnoreSchema 2

Ignorerar alla infogade scheman och läser in data i det befintliga DataSet schemat. Om några data inte matchar det befintliga schemat ignoreras de (inklusive data från olika namnområden som definierats för DataSet). Om data är ett DiffGram, IgnoreSchema har samma funktioner som DiffGram.

InferSchema 3

Ignorerar alla infogade scheman, härleder schema från data och läser in data. Om det DataSet redan innehåller ett schema utökas det aktuella schemat genom att lägga till nya tabeller eller lägga till kolumner i befintliga tabeller. Ett undantag utlöses om den härledda tabellen redan finns men med ett annat namnområde, eller om någon av de härledda kolumnerna står i konflikt med befintliga kolumner.

DiffGram 4

Läser ett DiffGram och tillämpar ändringar från DiffGram på DataSet. Semantiken är identisk med en Merge(DataSet) åtgärds. Precis som med åtgärden Merge(DataSet)RowState bevaras värden. Indata till ReadXml(XmlReader) med DiffGrams ska endast hämtas med utdata från WriteXml(Stream) som ett DiffGram.

Målet DataSet måste ha samma schema som det DataSet som WriteXml DiffGram anropas på. Annars misslyckas DiffGram-sammanfogningsåtgärden och ett undantag genereras.

Fragment 5

Läser XML-fragment, till exempel de som genereras genom att köra FOR XML-frågor, mot en instans av SQL Server. När XmlReadMode är inställt på Fragment, läss standardnamnområdet som det infogade schemat.

InferTypedSchema 6

Ignorerar alla infogade scheman, härleder ett starkt skrivet schema från data och läser in data. Om typen inte kan härledas från data tolkas den som strängdata. Om det DataSet redan innehåller ett schema utökas det aktuella schemat, antingen genom att lägga till nya tabeller eller genom att lägga till kolumner i befintliga tabeller. Ett undantag utlöses om den härledda tabellen redan finns men med ett annat namnområde, eller om någon av de härledda kolumnerna står i konflikt med befintliga kolumner.

Kommentarer

Använd medlemmarna i den här uppräkningen när du anger parametern ReadMode för DataSet.ReadXml metoden.

Note

Auto kan vara långsammare än att ange XmlReadMode ett explicit alternativ.

Auto utför den lämpligaste av dessa åtgärder:

  • Om data är ett DiffGram anger du XML-läsläget till DiffGram.

  • Om datauppsättningen redan har ett schema, eller om dokumentet innehåller ett infogat schema, anger du XML-läsläget till ReadSchema.

  • Om datauppsättningen inte redan har ett schema och dokumentet inte innehåller något in-line-schema anger du XML-läsläget till InferSchema.

Gäller för