XmlReadMode Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
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, |
| 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å |
| 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.