XmlReadMode Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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, |
| 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 |
| 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.