XmlReadMode Énumération

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Spécifie la façon de lire les 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

Auto	0	Mode lecture par défaut.
DiffGram	4	Lit un DiffGram en affectant les modifications du DiffGram au DataSet. La sémantique est identique à celle d'une opération Merge(DataSet). Comme lors de l'opération Merge(DataSet), les valeurs RowState sont conservées. L'entrée pour ReadXml(XmlReader) à l'aide de DiffGrams doit uniquement être obtenue en utilisant la sortie de WriteXml(Stream) en tant que DiffGram. Le DataSet cible doit avoir le même schéma que le DataSet sur lequel est appelé WriteXml en tant que DiffGram. Sinon, l’opération de fusion du DiffGram échoue et une exception est levée.
Fragment	5	Lit des fragements XML, tels ceux qui sont générés suite à l'exécution de requêtes FOR XML, sur une instance de SQL Server. Lorsque la valeur de XmlReadMode est Fragment, l'espace de noms par défaut est lu en tant que schéma inline.
IgnoreSchema	2	Ignore tout schéma inline et lit les données dans le schéma DataSet existant. Si des données ne correspondent pas au schéma existant, elles sont ignorées (y compris les données d'espaces de noms différents définis pour le DataSet). Si les données sont un DiffGram, IgnoreSchema fonctionne comme DiffGram.
InferSchema	3	Ignore tout schéma inline, déduit le schéma à partir des données et charge ces dernières. Si DataSet contient déjà un schéma, le schéma en cours est étendu par l'ajout de nouveaux tableaux ou l'ajout de colonnes aux tableaux existants. Une exception est levée si le tableau déduit existe déjà avec un espace de noms différent, ou si une ou plusieurs des colonnes obtenues entrent en conflit avec des colonnes existantes.
InferTypedSchema	6	Ignore tout schéma inline, déduit un schéma fortement typé à partir des données et charge ces dernières. Si le type ne peut pas être déduit à partir des données, il est interprété en tant que données de type chaîne. Si DataSet contient déjà un schéma, le schéma en cours est étendu par l'ajout de nouveaux tableaux ou l'ajout de colonnes aux tableaux existants. Une exception est levée si le tableau déduit existe déjà avec un espace de noms différent, ou si une ou plusieurs des colonnes obtenues entrent en conflit avec des colonnes existantes.
ReadSchema	1	Lit tout schéma inline et charge les données. Si DataSet contient déjà un schéma, de nouveaux tableaux peuvent être ajoutés à ce dernier, mais une exception est levée si un tableau du schéma inline existe déjà dans DataSet.

Remarques

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

Notes

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 de lecture XML sur DiffGram.

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

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