XmlReadMode XmlReadMode XmlReadMode XmlReadMode Enum

Définition

Spécifie la façon de lire les données XML et un schéma relationnel dans un DataSet.Specifies how to read XML data and a relational schema into a DataSet.

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

Champs

Auto Auto Auto Auto 0

Mode lecture par défaut.The default read mode.

DiffGram DiffGram DiffGram DiffGram 4

Lit un DiffGram en affectant les modifications du DiffGram au DataSet.Reads a DiffGram, applying changes from the DiffGram to the DataSet. La sémantique est identique à celle d'une opération Merge(DataSet).The semantics are identical to those of a Merge(DataSet) operation. Comme lors de l'opération Merge(DataSet), les valeurs RowState sont conservées.As with the Merge(DataSet) operation, RowState values are preserved. 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.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

Le DataSet cible doit avoir le même schéma que le DataSet sur lequel est appelé WriteXml en tant que DiffGram.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. Sinon, l’opération de fusion du DiffGram échoue et une exception est levée.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment Fragment Fragment 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.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Lorsque la valeur de XmlReadMode est Fragment, l'espace de noms par défaut est lu en tant que schéma inline.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema IgnoreSchema IgnoreSchema IgnoreSchema 2

Ignore tout schéma inline et lit les données dans le schéma DataSet existant.Ignores any inline schema and reads data into the existing DataSet schema. 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).If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Si les données sont un DiffGram, IgnoreSchema fonctionne comme DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema InferSchema InferSchema InferSchema 3

Ignore tout schéma inline, déduit le schéma à partir des données et charge ces dernières.Ignores any inline schema, infers schema from the data and loads the data. 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.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. 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.An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

InferTypedSchema InferTypedSchema InferTypedSchema InferTypedSchema 6

Ignore tout schéma inline, déduit un schéma fortement typé à partir des données et charge ces dernières.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. 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.If the type cannot be inferred from the data, it is interpreted as string data. 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.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. 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.An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

ReadSchema ReadSchema ReadSchema ReadSchema 1

Lit tout schéma inline et charge les données.Reads any inline schema and loads the data. 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.If the DataSet already contains schema, new tables may be added to the schema, but an exception is thrown if any tables in the inline schema already exist in the DataSet.

Remarques

Utilisez les membres de cette énumération lors de ReadMode la définition du DataSet.ReadXml paramètre de la méthode.Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Notes

Autole mode peut être plus lent XmlReadMode que la définition d’une option explicite.Auto mode may be slower than setting XmlReadMode to an explicit option.

Autoeffectue les actions les plus appropriées:Auto performs the most appropriate of these actions:

  • Si les données sont un DiffGram, définit le mode de lecture XML DiffGramsur.If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Si le DataSet 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.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • 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 de InferSchemalecture XML sur.If the dataset does not already have a schema and the document does not contain an in-line schema, sets the XML read mode to InferSchema.

S’applique à