XmlReadMode Enum

Definitie

Hiermee geeft u op hoe XML-gegevens en een relationeel schema in een DataSet.

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

Velden

Name Waarde Description
Auto 0

De standaardleesmodus.

ReadSchema 1

Leest een inlineschema en laadt de gegevens. Als het DataSet al een schema bevat, kunnen nieuwe tabellen worden toegevoegd aan het schema, maar er wordt een uitzondering gegenereerd als er al tabellen in het inlineschema aanwezig zijn in het DataSet.

IgnoreSchema 2

Negeert een inlineschema en leest gegevens in het bestaande DataSet schema. Als gegevens niet overeenkomen met het bestaande schema, worden deze verwijderd (inclusief gegevens uit verschillende naamruimten die zijn gedefinieerd voor het DataSet). Als de gegevens een DiffGram zijn, IgnoreSchema heeft dezelfde functionaliteit als DiffGram.

InferSchema 3

Hiermee negeert u een inlineschema, wordt het schema afgeleid van de gegevens en worden de gegevens geladen. Als het DataSet al een schema bevat, wordt het huidige schema uitgebreid door nieuwe tabellen toe te voegen of kolommen toe te voegen aan bestaande tabellen. Er wordt een uitzondering gegenereerd als de uitgestelde tabel al bestaat, maar met een andere naamruimte, of als een van de uitgestelde kolommen conflicteert met bestaande kolommen.

DiffGram 4

Leest een DiffGram, waarbij wijzigingen van het DiffGram worden toegepast op de DataSet. De semantiek is identiek aan die van een Merge(DataSet) bewerking. Net als bij de Merge(DataSet) bewerking RowState blijven waarden behouden. Invoer naar ReadXml(XmlReader) met DiffGrams mag alleen worden verkregen met behulp van de uitvoer van WriteXml(Stream) als diffgram.

Het doel DataSet moet hetzelfde schema hebben als waarop DataSetWriteXml DiffGram wordt aangeroepen. Anders mislukt de samenvoegbewerking diffgram en wordt er een uitzondering gegenereerd.

Fragment 5

Leest XML-fragmenten, zoals fragmenten die worden gegenereerd door het uitvoeren van FOR XML-query's, op basis van een exemplaar van SQL Server. Wanneer XmlReadMode dit is ingesteld Fragment, wordt de standaardnaamruimte gelezen als het inlineschema.

InferTypedSchema 6

Negeert een inlineschema, leiden een sterk getypt schema af van de gegevens en laadt de gegevens. Als het type niet kan worden afgeleid van de gegevens, wordt dit geïnterpreteerd als tekenreeksgegevens. Als het DataSet al een schema bevat, wordt het huidige schema uitgebreid door nieuwe tabellen toe te voegen of door kolommen toe te voegen aan bestaande tabellen. Er wordt een uitzondering gegenereerd als de uitgestelde tabel al bestaat, maar met een andere naamruimte, of als een van de uitgestelde kolommen conflicteert met bestaande kolommen.

Opmerkingen

Gebruik de leden van deze opsomming bij het instellen van de ReadMode parameter van de DataSet.ReadXml methode.

Note

Auto de modus kan langzamer zijn dan het instellen XmlReadMode van een expliciete optie.

Auto voert de meest geschikte acties uit:

  • Als de gegevens een DiffGram zijn, stelt u de XML-leesmodus in op DiffGram.

  • Als de gegevensset al een schema heeft of als het document een inlineschema bevat, stelt u de XML-leesmodus in op ReadSchema.

  • Als de gegevensset nog geen schema heeft en het document geen inlineschema bevat, stelt u de XML-leesmodus in op InferSchema.

Van toepassing op