DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml Method

Definizione

Legge i dati e lo schema XML nell'oggetto DataSet.Reads XML schema and data into the DataSet.

Overload

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file e l'oggetto XmlReadMode specificati.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file specificato.Reads XML schema and data into the DataSet using the specified file.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader specificata.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream specificata.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader specificata.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode

Parametri

reader
XmlReader XmlReader XmlReader XmlReader

Classe XmlReader da cui eseguire la lettura.The XmlReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno dei valori di XmlReadMode.One of the XmlReadMode values.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet oggetto include targetNamespaceun oggetto, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando ReadXml si chiama per DataSet caricare l'oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file e l'oggetto XmlReadMode specificati.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (string fileName, System.Data.XmlReadMode mode);
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String, mode As XmlReadMode) As XmlReadMode

Parametri

fileName
String String String String

Nome del file, incluso il percorso, da cui eseguire la lettura.The filename (including the path) from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno dei valori di XmlReadMode.One of the XmlReadMode values.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Eccezioni

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet oggetto include targetNamespaceun oggetto, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando ReadXml si chiama per DataSet caricare l'oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Sicurezza

FileIOPermission
per la lettura e la scrittura di file.for reading and writing files. Enumerazione associata:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Vedi anche

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode

Parametri

stream
Stream Stream Stream Stream

Classe Stream da cui eseguire la lettura.The Stream from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno dei valori di XmlReadMode.One of the XmlReadMode values.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Lo stesso vale per i WriteXml metodi e WriteXmlSchema , rispettivamente.The same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Quando si utilizza ReadXml e si imposta XmlReadMode su Diffgram, il contenuto della destinazione DataSet e dell'originale DataSet può essere diverso a causa del modo in cui il DiffGram viene generato ed elaborato.When you use ReadXml and you set XmlReadMode to Diffgram, the content of the target DataSet and the original DataSet may differ because of how the diffgram is generated and processed. Per ulteriori informazioni su DiffGram, vedere DiffGram.For more information on diffgrams, see DiffGrams.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet include targetNamespace, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando si chiama ReadXml per caricare l' DataSet oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode

Parametri

reader
TextReader TextReader TextReader TextReader

Classe TextReader da cui eseguire la lettura.The TextReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno dei valori di XmlReadMode.One of the XmlReadMode values.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet include targetNamespace, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando si chiama ReadXml per caricare l' DataSet oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file specificato.Reads XML schema and data into the DataSet using the specified file.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
member this.ReadXml : string -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String) As XmlReadMode

Parametri

fileName
String String String String

Nome del file, incluso il percorso, da cui eseguire la lettura.The filename (including the path) from which to read.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Eccezioni

Esempi

Nell'esempio seguente viene innanzitutto creato un DataSet oggetto semplice DataTablecon una, due colonne e dieci righe.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Lo DataSet schema e i dati vengono scritti su disco richiamando WriteXml il metodo.The DataSet schema and data are written to disk by invoking the WriteXml method. Viene creato DataSet un secondo e il ReadXml metodo viene usato per compilare lo schema e i dati.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithStreamReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

    // Add ten rows.
    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    OriginalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the schema and data to an XML file.
    string xmlFilename = "XmlDocument.xml";

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename);

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the schema and data to an XML file.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename)

    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename)

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        Dim row As DataRow
        For Each row In  table.Rows
            Dim column As DataColumn
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                    row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet oggetto include targetNamespaceun oggetto, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando ReadXml si chiama per DataSet caricare l'oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Sicurezza

FileIOPermission
per la lettura e la scrittura di file.for reading and writing files. Enumerazione associata:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Vedi anche

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader specificata.Reads XML schema and data into the DataSet using the specified TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

Parametri

reader
TextReader TextReader TextReader TextReader

Oggetto TextReader da cui leggere schema e dati.The TextReader from which to read the schema and data.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Esempi

Nell'esempio seguente viene innanzitutto creato un DataSet oggetto semplice DataTablecon una, due colonne e dieci righe.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Lo DataSet schema e i dati vengono scritti su disco richiamando WriteXml il metodo.The DataSet schema and data are written to disk by invoking the WriteXml method. Viene creato DataSet un secondo e il ReadXml metodo viene usato per compilare lo schema e i dati.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet  
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();
   
    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet include targetNamespace, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando si chiama ReadXml per caricare l' DataSet oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Le classi che ereditano TextReader dalla classe includono StreamReader le StringReader classi e.Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream specificata.Reads XML schema and data into the DataSet using the specified Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Parametri

stream
Stream Stream Stream Stream

Oggetto derivato da Stream.An object that derives from Stream.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Esempi

Nell'esempio seguente viene innanzitutto creato un DataSet oggetto semplice DataTablecon una, due colonne e dieci righe.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Lo DataSet schema e i dati vengono scritti su disco richiamando WriteXml il metodo.The DataSet schema and data are written to disk by invoking the WriteXml method. Viene creato DataSet un secondo e il ReadXml metodo viene usato per compilare lo schema e i dati.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet  
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();
   
    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet include targetNamespace, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando si chiama ReadXml per caricare l' DataSet oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" nello schema XML, come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema, as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader specificata.Reads XML schema and data into the DataSet using the specified XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parametri

reader
XmlReader XmlReader XmlReader XmlReader

Classe XmlReader da cui eseguire la lettura.The XmlReader from which to read.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.The XmlReadMode used to read the data.

Esempi

Nell'esempio seguente viene innanzitutto creato un DataSet oggetto semplice DataTablecon una, due colonne e dieci righe.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Lo DataSet schema e i dati vengono scritti su disco richiamando WriteXml il metodo.The DataSet schema and data are written to disk by invoking the WriteXml method. Viene creato DataSet un secondo e il ReadXml metodo viene usato per compilare lo schema e i dati.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithXMLReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

    // Add ten rows.
    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    OriginalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the XML schema and data to file with FileStream.
    string xmlFilename = "XmlDocument.xml";

    // Create FileStream    
    System.IO.FileStream fsWriteXml = 
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Create an XmlTextWriter to write the file.
    System.Xml.XmlTextWriter xmlWriter = 
        new System.Xml.XmlTextWriter
        (fsWriteXml, System.Text.Encoding.Unicode);

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema); 

    // Close the FileStream.
    fsWriteXml.Close();
   
    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream fsReadXml = 
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Open);

    // Create an XmlTextReader to read the file.
    System.Xml.XmlTextReader xmlReader = 
        new System.Xml.XmlTextReader(fsReadXml);

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);

    // Close the XmlTextReader
    xmlReader.Close();

    // Print out values of each table in the DataSet 
    // fusing the unction defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the XML schema and data to file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Create FileStream    
    Dim fsWriteXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter to write the file.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
        (fsWriteXml, System.Text.Encoding.Unicode)

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)

    ' Close the FileStream.
    fsWriteXml.Close()
        
    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
        
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim fsReadXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Open)

    ' Create an XmlTextReader to read the file.
    Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)

    ' Close the XmlTextReader
    xmlReader.Close()
        
    ' Print out values of each table in the DataSet using the 
    ' function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
    
 Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName)
         For Each row In  table.Rows
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())

             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub

Commenti

Il ReadXml metodo consente di leggere solo i dati o i dati e lo schema in un DataSet oggetto da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Per leggere sia i dati che lo schema, usare uno ReadXML degli overload che include il mode parametro e impostarne il valore su ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Si noti che lo stesso vale per i WriteXml metodi WriteXmlSchema e, rispettivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Per scrivere dati XML o sia schema che dati da DataSet, utilizzare il WriteXml metodo.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Per scrivere solo lo schema, usare il WriteXmlSchema metodo.To write just the schema, use the WriteXmlSchema method.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna DataRow nell'oggetto che viene letto o scritto in IDynamicMetaObjectProvider implementa e non implementa IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Se viene specificato uno schema inline, lo schema inline viene utilizzato per estendere la struttura relazionale esistente prima di caricare i dati.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Se non viene specificato alcuno schema inline, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Se non è possibile estendere lo schema tramite l'inferenza per esporre tutti i dati, viene generata un'eccezione.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

Non associa un elemento XML con l'oggetto corrispondente DataColumn o DataTable quando i caratteri XML validi, ad esempio (""), sono preceduti da un carattere di escape nel codice XML serializzato. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Solo DataSet i caratteri XML non validi vengono sottoposte a escape nei nomi degli elementi XML e pertanto possono utilizzare solo lo stesso oggetto.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Quando i caratteri validi nel nome dell'elemento XML vengono sottoposto a escape, l'elemento viene ignorato durante l'elaborazione.When legal characters in XML element name are escaped, the element is ignored while processing.

Se lo schema XML per un DataSet oggetto include targetNamespaceun oggetto, i dati potrebbero non essere letti e potrebbero verificarsi eccezioni quando ReadXml si chiama per DataSet caricare l'oggetto con XML che contiene elementi senza spazio dei nomi idoneo.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualified" in XML Schema come illustrato nell'esempio seguente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

System.Xml.XmlTextReader eredita da XmlReader.System.Xml.XmlTextReader inherits from XmlReader.

Nota

Se DataSet lo schema per contiene elementi DataSet con lo stesso nome, ma di tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in con ReadXml specificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa la versione di .NET Framework 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Vedi anche

Si applica a