XmlReadMode Enumerazione

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.dll

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

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

Ereditarietà

Object

ValueType

Enum

XmlReadMode

Campi

Nome	Valore	Descrizione
Auto	0	Modalità di lettura predefinita.
ReadSchema	1	Legge qualsiasi schema inline e carica i dati. Se l'oggetto DataSet contiene già lo schema, è possibile aggiungere nuove tabelle allo schema, ma viene generata un'eccezione se sono già presenti tabelle nello schema inline in DataSet.
IgnoreSchema	2	Ignora qualsiasi schema inline e legge i dati nello schema esistente DataSet . Se i dati non corrispondono allo schema esistente, vengono eliminati (inclusi i dati di spazi dei nomi diversi definiti per ).DataSet Se i dati sono un DiffGram, IgnoreSchema ha la stessa funzionalità di DiffGram.
InferSchema	3	Ignora qualsiasi schema inline, deduce lo schema dai dati e carica i dati. Se l'oggetto DataSet contiene già uno schema, lo schema corrente viene esteso aggiungendo nuove tabelle o aggiungendo colonne alle tabelle esistenti. Viene generata un'eccezione se la tabella dedotta esiste già, ma con uno spazio dei nomi diverso o se una delle colonne dedotte è in conflitto con le colonne esistenti.
DiffGram	4	Legge un DiffGram, applicando le modifiche da DiffGram a DataSet. La semantica è identica a quella di un'operazione Merge(DataSet) . Come per l'operazione Merge(DataSet) , RowState i valori vengono mantenuti. L'input a ReadXml(XmlReader) con DiffGrams deve essere ottenuto solo usando l'output da WriteXml(Stream) come DiffGram. La destinazione DataSet deve avere lo stesso schema di DataSet su cui WriteXml viene chiamato DiffGram. In caso contrario, l'operazione di unione DiffGram non riesce e viene generata un'eccezione.
Fragment	5	Legge frammenti XML, ad esempio quelli generati eseguendo query FOR XML, su un'istanza di SQL Server. Quando XmlReadMode è impostato su Fragment, lo spazio dei nomi predefinito viene letto come schema inline.
InferTypedSchema	6	Ignora qualsiasi schema inline, deduce uno schema fortemente tipizzato dai dati e carica i dati. Se il tipo non può essere dedotto dai dati, viene interpretato come dati stringa. Se l'oggetto DataSet contiene già uno schema, lo schema corrente viene esteso aggiungendo nuove tabelle o aggiungendo colonne alle tabelle esistenti. Viene generata un'eccezione se la tabella dedotta esiste già, ma con uno spazio dei nomi diverso o se una delle colonne dedotte è in conflitto con le colonne esistenti.

Commenti

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

Note

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 un DiffGram, imposta la modalità di lettura XML su DiffGram.

• Se il set di dati dispone già di 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.