XmlReadMode Enumerazione

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Specifica come leggere i dati XML e uno schema relazionale in un oggetto DataSet.

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

Ereditarietà

Object

ValueType

Enum

XmlReadMode

Campi

Auto	0	Modalità di lettura predefinita.
DiffGram	4	Legge un DiffGram, applicando modifiche dal DiffGram all'oggetto DataSet. Questa semantica si presenta identica a quella di un'operazione Merge(DataSet). Analogamente all'operazione Merge(DataSet), i valori della proprietà RowState vengono conservati. L'input a ReadXml(XmlReader) con DiffGram dovrebbe essere ottenuto solo utilizzando l'output da WriteXml(Stream) come DiffGram. L'oggetto DataSet deve avere lo stesso schema dell'oggetto DataSet per cui viene chiamato il metodo WriteXml come DiffGram. In caso contrario, l'operazione di merge DiffGram ha esito negativo e viene generata un'eccezione.
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. Quando XmlReadMode è impostato su Fragment, lo spazio dei nomi predefinito viene letto come schema inline.
IgnoreSchema	2	Ignora tutti gli schemi inline e legge i dati nello schema DataSet esistente. 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. Se i dati sono di tipo DiffGram, IgnoreSchema presenta la stessa funzionalità di DiffGram.
InferSchema	3	Ignora tutti gli schemi inline, deriva gli schemi dai dati e carica i dati. 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. 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.
InferTypedSchema	6	Ignora tutti gli schemi inline, deriva uno schema fortemente tipizzato dai dati e carica i dati. Se non è possibile derivare il tipo dai dati, i dati vengono interpretati come dati di tipo stringa. 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. 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.
ReadSchema	1	Legge tutti gli schemi inline e carica i dati. 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.

Commenti

Utilizzare i membri di questa enumerazione quando si imposta il ReadMode parametro del DataSet.ReadXml metodo .

Nota

Auto la modalità può essere più lenta rispetto all'impostazione XmlReadMode di un'opzione esplicita.

Auto esegue le azioni più appropriate:

• Se i dati sono diffGram, imposta la modalità di lettura XML su DiffGram.

• Se il set di dati ha già uno schema o se il documento contiene uno schema in linea, imposta la modalità di lettura XML su ReadSchema.

• Se il set di dati non dispone già di uno schema e il documento non contiene uno schema in linea, imposta la modalità di lettura XML su InferSchema.