XmlReadMode Énumération

Définition

Espace de noms:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Spécifie comment lire des données XML et un schéma relationnel dans un DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Héritage
Object
ValueType
Enum
XmlReadMode

Champs

Nom Valeur Description
Auto 0

Mode de lecture par défaut.
ReadSchema 1

Lit n’importe quel schéma inline et charge les données. Si le DataSet schéma contient déjà, de nouvelles tables peuvent être ajoutées au schéma, mais une exception est levée si des tables du schéma inline existent déjà dans le DataSetschéma.
IgnoreSchema 2

Ignore tout schéma inline et lit les données dans le schéma existant DataSet . Si des données ne correspondent pas au schéma existant, elles sont ignorées (y compris les données provenant d’espaces de noms différents définis pour le DataSet). Si les données sont un DiffGram, IgnoreSchema ont les mêmes fonctionnalités que DiffGram.
InferSchema 3

Ignore tout schéma inline, déduit le schéma des données et charge les données. Si le DataSet schéma contient déjà un schéma, le schéma actuel est étendu en ajoutant de nouvelles tables ou en ajoutant des colonnes à des tables existantes. Une exception est levée si la table déduite existe déjà, mais avec un espace de noms différent ou si l’une des colonnes déduites est en conflit avec les colonnes existantes.
DiffGram 4

Lit un DiffGram, en appliquant des modifications de DiffGram à l’objet DataSet. La sémantique est identique à celle d’une Merge(DataSet) opération. Comme pour l’opération Merge(DataSet) , RowState les valeurs sont conservées. L’entrée avec DiffGrams doit uniquement être obtenue à ReadXml(XmlReader) l’aide de la sortie sous WriteXml(Stream) la forme d’un DiffGram.

La cible DataSet doit avoir le même schéma que celui DataSet sur lequel WriteXml DiffGram est appelé. Sinon, l’opération de fusion DiffGram échoue et une exception est levée.
Fragment 5

Lit des fragments XML, tels que ceux générés par l’exécution de requêtes FOR XML, sur une instance de SQL Server. Quand XmlReadMode la valeur est définie Fragment, l’espace de noms par défaut est lu comme schéma inline.
InferTypedSchema 6

Ignore tout schéma inline, déduit un schéma fortement typé à partir des données et charge les données. Si le type ne peut pas être déduit des données, il est interprété comme des données de chaîne. Si le DataSet schéma contient déjà un schéma, le schéma actuel est étendu, soit en ajoutant de nouvelles tables, soit en ajoutant des colonnes à des tables existantes. Une exception est levée si la table déduite existe déjà, mais avec un espace de noms différent ou si l’une des colonnes déduites est en conflit avec les colonnes existantes.

Remarques

Utilisez les membres de cette énumération lors de la définition du ReadMode paramètre de la DataSet.ReadXml méthode.

Note

Auto le mode peut être plus lent que la définition XmlReadMode d’une option explicite.

Auto effectue les actions les plus appropriées :

  • Si les données sont un DiffGram, définissez le mode DiffGramde lecture XML sur .

  • Si le jeu de données possède déjà un schéma ou si le document contient un schéma en ligne, définit le mode ReadSchemade lecture XML sur .

  • Si le jeu de données n’a pas encore de schéma et que le document ne contient pas de schéma en ligne, définit le mode InferSchemade lecture XML sur .

S’applique à