DataSet.ReadXml Metodo

Definizione

Legge i dati e lo schema XML nell'oggetto DataSet.

Overload

ReadXml(XmlReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader e l'enumerazione XmlReadMode specificate.

ReadXml(String, XmlReadMode)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file e l'oggetto XmlReadMode specificati.

ReadXml(Stream, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream e l'enumerazione XmlReadMode specificate.

ReadXml(TextReader, XmlReadMode)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader e l'enumerazione XmlReadMode specificate.

ReadXml(String)

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file specificato.

ReadXml(TextReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader specificata.

ReadXml(Stream)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream specificata.

ReadXml(XmlReader)

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader specificata.

ReadXml(XmlReader, XmlReadMode)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader e l'enumerazione XmlReadMode specificate.

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);
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

Classe XmlReader da cui eseguire la lettura.

mode
XmlReadMode

Uno dei valori di XmlReadMode.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Commenti

Il ReadXml metodo consente di leggere solo i dati o entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include , targetNamespaceè possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare DataSet con XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(String, XmlReadMode)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file e l'oggetto XmlReadMode specificati.

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

Nome del file, incluso il percorso, da cui eseguire la lettura.

mode
XmlReadMode

Uno dei valori di XmlReadMode.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Eccezioni

La classe FileIOPermission non è impostata su Read.

Commenti

Il ReadXml metodo consente di leggere solo i dati o entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include , targetNamespaceè possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare DataSet con XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(Stream, XmlReadMode)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream e l'enumerazione XmlReadMode specificate.

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);
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
Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode

Parametri

stream
Stream

Classe Stream da cui eseguire la lettura.

mode
XmlReadMode

Uno dei valori di XmlReadMode.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Commenti

Il ReadXml metodo consente di leggere solo i dati o entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Quando si usa ReadXml e si imposta su DiffgramXmlReadMode , il contenuto della destinazione DataSet e l'originale DataSet possono differire a causa del modo in cui viene generato ed elaborato il diffgramma. Per altre informazioni sui diffgrammi, vedere DiffGrams.

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include targetNamespace, è possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare con DataSet XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(TextReader, XmlReadMode)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader e l'enumerazione XmlReadMode specificate.

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);
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

Classe TextReader da cui eseguire la lettura.

mode
XmlReadMode

Uno dei valori di XmlReadMode.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Commenti

Il ReadXml metodo consente di leggere solo i dati o entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include targetNamespace, è possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare con DataSet XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(String)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file specificato.

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

Nome del file, incluso il percorso, da cui eseguire la lettura.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Eccezioni

La classe FileIOPermission non è impostata su Read.

Esempio

Nell'esempio seguente viene innanzitutto creata una semplice DataSet con una DataTable, due colonne e dieci righe. Lo schema e i DataSet dati vengono scritti su disco richiamando il WriteXml metodo . Viene creato un secondo DataSet e viene usato il ReadXml metodo per riempirlo con schema e dati.

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 entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include , targetNamespaceè possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare DataSet con XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(TextReader)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader specificata.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
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

Oggetto TextReader da cui leggere schema e dati.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Esempio

Nell'esempio seguente viene innanzitutto creata una semplice DataSet con una DataTable, due colonne e dieci righe. Lo schema e i DataSet dati vengono scritti su disco richiamando il WriteXml metodo . Viene creato un secondo DataSet e viene usato il ReadXml metodo per riempirlo con schema e dati.

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 entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include targetNamespace, è possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare con DataSet XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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 dalla TextReader classe includono le StreamReader classi e StringReader .

Nota

Se lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(Stream)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream specificata.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ 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
Public Function ReadXml (stream As Stream) As XmlReadMode

Parametri

stream
Stream

Oggetto derivato da Stream.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Esempio

Nell'esempio seguente viene innanzitutto creata una semplice DataSet con una DataTable, due colonne e dieci righe. Lo schema e i DataSet dati vengono scritti su disco richiamando il WriteXml metodo . Viene creato un secondo DataSet e viene usato il ReadXml metodo per riempirlo con schema e dati.

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 entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include targetNamespace, è possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare con DataSet XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema, come illustrato nell'esempio seguente.

<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 lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a

ReadXml(XmlReader)

Origine:
DataSet.cs
Origine:
DataSet.cs
Origine:
DataSet.cs

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader specificata.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
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

Classe XmlReader da cui eseguire la lettura.

Restituisce

Modalità XmlReadMode utilizzata per leggere i dati.

Esempio

Nell'esempio seguente viene innanzitutto creata una semplice DataSet con una DataTable, due colonne e dieci righe. Lo schema e i DataSet dati vengono scritti su disco richiamando il WriteXml metodo . Viene creato un secondo DataSet e viene usato il ReadXml metodo per riempirlo con schema e dati.

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 entrambi i dati e lo schema in un DataSet da un documento XML, mentre il ReadXmlSchema metodo legge solo lo schema. Per leggere sia i dati che lo schema, usare uno degli ReadXML overload che includono il parametro e impostarne il mode valore su ReadSchema.

Si noti che lo stesso vale rispettivamente per i WriteXml metodi e WriteXmlSchema . Per scrivere dati XML o sia schema che dati da DataSet, usare il WriteXml metodo . Per scrivere solo lo schema, usare il WriteXmlSchema metodo .

Nota

Verrà InvalidOperationException generata un'eccezione se un tipo di colonna nell'oggetto DataRow da cui viene letto o scritto per implementare IDynamicMetaObjectProvider e non implementa IXmlSerializable.

Se viene specificato uno schema in linea, lo schema in linea viene usato per estendere la struttura relazionale esistente prima di caricare i dati. Se sono presenti conflitti, ad esempio la stessa colonna nella stessa tabella definita con tipi di dati diversi, viene generata un'eccezione.

Se non viene specificato alcuno schema in linea, la struttura relazionale viene estesa tramite inferenza, se necessario, in base alla struttura del documento XML. Se lo schema non può essere esteso tramite inferenza per esporre tutti i dati, viene generata un'eccezione.

Nota

L'oggetto DataSet non associa un elemento XML al corrispondente DataColumn o DataTable quando i caratteri XML legali come ("_") vengono preceduti da un carattere di escape nel codice XML serializzato. L'oggetto DataSet stesso esegue solo l'escape dei caratteri XML non validi nei nomi degli elementi XML e pertanto può utilizzare solo lo stesso. Quando i caratteri legali nel nome dell'elemento XML vengono preceduti da un carattere di escape, l'elemento viene ignorato durante l'elaborazione.

Se xml Schema per un DataSet include , targetNamespaceè possibile che i dati non vengano letti e che si verifichino eccezioni quando si chiama ReadXml per caricare DataSet con XML che contiene elementi senza spazio dei nomi idoneo. Per leggere elementi non qualificati, impostare elementFormDefault uguale a "qualificato" in XML Schema come illustrato nell'esempio seguente.

<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.

Nota

Se lo schema per l'oggetto DataSet contiene elementi con lo stesso nome, ma un tipo diverso, nello stesso spazio dei nomi, viene generata un'eccezione quando si tenta di leggere lo schema in DataSet con ReadXml specificando XmlReadMode.ReadSchema. Questa eccezione non si verifica se si usa .NET Framework versione 1.0.

Vedi anche

Si applica a