XmlReadMode XmlReadMode XmlReadMode XmlReadMode Enum

Definizione

Specifica come leggere i dati XML e uno schema relazionale in un oggetto 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
Ereditarietà

Campi

Auto Auto Auto Auto 0

Modalità di lettura predefinita.The default read mode.

DiffGram DiffGram DiffGram DiffGram 4

Legge un DiffGram, applicando modifiche dal DiffGram all'oggetto DataSet.Reads a DiffGram, applying changes from the DiffGram to the DataSet. Questa semantica si presenta identica a quella di un'operazione Merge(DataSet).The semantics are identical to those of a Merge(DataSet) operation. Analogamente all'operazione Merge(DataSet), i valori della proprietà RowState vengono conservati.As with the Merge(DataSet) operation, RowState values are preserved. L'input a ReadXml(XmlReader) con DiffGram dovrebbe essere ottenuto solo utilizzando l'output da WriteXml(Stream) come DiffGram.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

L'oggetto DataSet deve avere lo stesso schema dell'oggetto DataSet per cui viene chiamato il metodo WriteXml come DiffGram.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. In caso contrario, l'operazione di merge DiffGram ha esito negativo e viene generata un'eccezione.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment Fragment Fragment Fragment 5

Legge i frammenti XML, ad esempio i frammenti generati dall'esecuzione di query di tipo FOR XML, in base a un'istanza di SQL Server.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Quando XmlReadMode è impostato su Fragment, lo spazio dei nomi predefinito viene letto come schema inline.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema IgnoreSchema IgnoreSchema IgnoreSchema 2

Ignora tutti gli schemi inline e legge i dati nello schema DataSet esistente.Ignores any inline schema and reads data into the existing DataSet schema. Se non vi è corrispondenza tra i dati e lo schema esistente, i dati verranno eliminati, compresi i dati di diversi spazi dei nomi definiti per l'oggetto DataSet.If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Se i dati sono di tipo DiffGram, IgnoreSchema presenta la stessa funzionalità di DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema InferSchema InferSchema InferSchema 3

Ignora tutti gli schemi inline, deriva gli schemi dai dati e carica i dati.Ignores any inline schema, infers schema from the data and loads the data. Se nell'oggetto DataSet è già contenuto uno schema, lo schema corrente verrà esteso mediante l'aggiunta di nuove tabelle o l'aggiunta di nuove colonne alle tabelle esistenti.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. Verrà generata un'eccezione se esiste già una tabella derivata ma con un differente spazio dei nomi, o se si verificano conflitti tra le colonne derivate e le colonne esistenti.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

Ignora tutti gli schemi inline, deriva uno schema fortemente tipizzato dai dati e carica i dati.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. Se non è possibile derivare il tipo dai dati, i dati vengono interpretati come dati di tipo stringa.If the type cannot be inferred from the data, it is interpreted as string data. Se nell'oggetto DataSet è già contenuto uno schema, lo schema corrente verrà esteso mediante l'aggiunta di nuove tabelle o l'aggiunta di colonne alle tabelle esistenti.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. Verrà generata un'eccezione se esiste già una tabella derivata ma con un differente spazio dei nomi, o se si verificano conflitti tra le colonne derivate e le colonne esistenti.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

Legge tutti gli schemi inline e carica i dati.Reads any inline schema and loads the data. Se nell'oggetto DataSet sono già presenti schemi, è possibile che vengano aggiunte nuove tabelle allo schema, ma verrà generata un'eccezione se una tabella contenuta nello schema inline è già presente nell'oggetto 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.

Commenti

Usare i membri di questa enumerazione quando si impostano i ReadMode parametro del DataSet.ReadXml (metodo).Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Nota

Auto la modalità può essere più lenta dell'impostazione XmlReadMode su un'opzione specifica.Auto mode may be slower than setting XmlReadMode to an explicit option.

Auto Esegue il più appropriato di queste azioni:Auto performs the most appropriate of these actions:

  • Se i dati sono di tipo DiffGram, imposta il codice XML alla modalità di lettura per DiffGram.If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Se il set di dati ha già uno schema, o se il documento contiene uno schema inline, imposta il codice XML alla modalità di lettura per ReadSchema.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • Se il set di dati non dispone già di uno schema e il documento non contiene uno schema inline, imposta il codice XML alla modalità di lettura per InferSchema.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.

Si applica a