Questa documentazione è stata archiviata e non viene gestita.

Enumerazione XmlReadMode

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

Spazio dei nomi: System.Data
Assembly: System.Data (in system.data.dll)

public enum XmlReadMode
public enum XmlReadMode
public enum XmlReadMode

 Nome membroDescrizione
Supportato da .NET Compact FrameworkAutoValore predefinito.  

Esegue la più appropriata tra queste azioni:

Se i dati sono di tipo DiffGram, XmlReadMode viene impostato su DiffGram.

-oppure-

Se il dataset presenta già uno schema oppure nel documento è contenuto uno schema inline, XmlReadMode viene impostato su ReadSchema.

-oppure-

Se il dataset non presenta già uno schema e nel documento non è contenuto uno schema inline, XmlReadMode viene impostato su InferSchema.

Supportato da .NET Compact FrameworkDiffGramLegge un DiffGram, applicando modifiche dal DiffGram all'oggetto DataSet. Questa semantica si presenta identica a quella di un'operazione Merge. Analogamente all'operazione Merge, i valori della proprietà RowState vengono conservati. L'input a ReadXml con DiffGram dovrebbe essere ottenuto solo utilizzando l'output da WriteXml come DiffGram. 

È necessario che l'oggetto DataSet di destinazione presenti lo stesso schema dell'oggetto DataSet su cui viene chiamato WriteXml come DiffGram. In caso contrario, l'operazione di unione di DiffGram non verrà completata correttamente e verrà generata un'eccezione.

Supportato da .NET Compact FrameworkFragmentLegge 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. 
Supportato da .NET Compact FrameworkIgnoreSchemaIgnora 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
Supportato da .NET Compact FrameworkInferSchemaIgnora 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. 
Supportato da .NET Compact FrameworkInferTypedSchemaIgnora 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. 
Supportato da .NET Compact FrameworkReadSchemaLegge 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

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

NotaNota

La modalità Auto potrebbe risultare più lenta dell'impostazione di XmlReadMode su un'opzione specifica.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0

.NET Compact Framework

Supportato in: 2.0 1.0
Mostra: