DataSet.ReadXml Methode

Definition

Liest XML-Schema und -Daten in das DataSet.

Überlädt

Name Beschreibung
ReadXml(XmlReader, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen XmlReader und XmlReadMode.

ReadXml(String, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen Datei und XmlReadMode.

ReadXml(Stream, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen Stream und XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen TextReader und XmlReadMode.

ReadXml(String)

Liest XML-Schema und -Daten in die DataSet angegebene Datei.

ReadXml(TextReader)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen TextReader.

ReadXml(Stream)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen Stream.

ReadXml(XmlReader)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen XmlReader.

ReadXml(XmlReader, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen XmlReader und 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

Parameter

reader
XmlReader

Die XmlReader zu lesende Datei.

mode
XmlReadMode

Einer der XmlReadMode Werte.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet Objekt enthält targetNamespace, werden die Daten möglicherweise nicht gelesen, und beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, werden Ausnahmen auftreten. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(String, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen Datei und 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

Parameter

fileName
String

Der Dateiname (einschließlich des Pfads), aus dem gelesen werden soll.

mode
XmlReadMode

Einer der XmlReadMode Werte.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Ausnahmen

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet Objekt enthält targetNamespace, werden die Daten möglicherweise nicht gelesen, und beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, werden Ausnahmen auftreten. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(Stream, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen Stream und 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
Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode

Parameter

stream
Stream

Die Stream zu lesende Datei.

mode
XmlReadMode

Einer der XmlReadMode Werte.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Das gleiche gilt für die jeweiligen Methoden bzwWriteXmlSchema. für die WriteXml Methoden. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Wenn Sie das Ziel verwenden ReadXml und auf sie festlegen XmlReadModeDiffgram, kann sich der Inhalt des Ziels DataSet und des Originals DataSet aufgrund der Erstellung und Verarbeitung des Diffgrams unterscheiden. Weitere Informationen zu Diffgrams finden Sie unter DiffGrams.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet enthält targetNamespace, werden Die Daten möglicherweise nicht gelesen, und Beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(TextReader, XmlReadMode)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen TextReader und 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

Parameter

reader
TextReader

Die TextReader zu lesende Datei.

mode
XmlReadMode

Einer der XmlReadMode Werte.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet enthält targetNamespace, werden Die Daten möglicherweise nicht gelesen, und Beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(String)

Liest XML-Schema und -Daten in die DataSet angegebene Datei.

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

Parameter

fileName
String

Der Dateiname (einschließlich des Pfads), aus dem gelesen werden soll.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Ausnahmen

Beispiele

Im folgenden Beispiel wird zunächst eine einfache DataSet Zeile mit einer , zwei DataTableSpalten und zehn Zeilen erstellt. Das Schema und die DataSet Daten werden durch Aufrufen der WriteXml Methode auf den Datenträger geschrieben. Eine Sekunde DataSet wird erstellt, und die ReadXml Methode wird verwendet, um sie mit Schema und Daten auszufüllen.

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

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet Objekt enthält targetNamespace, werden die Daten möglicherweise nicht gelesen, und beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, werden Ausnahmen auftreten. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(TextReader)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen 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

Parameter

reader
TextReader

Die TextReader Datei, aus der das Schema und die Daten gelesen werden sollen.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Beispiele

Im folgenden Beispiel wird zunächst eine einfache DataSet Zeile mit einer , zwei DataTableSpalten und zehn Zeilen erstellt. Das Schema und die DataSet Daten werden durch Aufrufen der WriteXml Methode auf den Datenträger geschrieben. Eine Sekunde DataSet wird erstellt, und die ReadXml Methode wird verwendet, um sie mit Schema und Daten auszufüllen.

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

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet enthält targetNamespace, werden Die Daten möglicherweise nicht gelesen, und Beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Klassen, die von der TextReader Klasse erben, enthalten die StreamReader Klassen und StringReader Klassen.

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(Stream)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen 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

Parameter

stream
Stream

Ein Objekt, das von Stream.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Beispiele

Im folgenden Beispiel wird zunächst eine einfache DataSet Zeile mit einer , zwei DataTableSpalten und zehn Zeilen erstellt. Das Schema und die DataSet Daten werden durch Aufrufen der WriteXml Methode auf den Datenträger geschrieben. Eine Sekunde DataSet wird erstellt, und die ReadXml Methode wird verwendet, um sie mit Schema und Daten auszufüllen.

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

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet enthält targetNamespace, werden Die Daten möglicherweise nicht gelesen, und Beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

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

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für:

ReadXml(XmlReader)

Liest XML-Schema und -Daten in die verwendung der DataSet angegebenen 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

Parameter

reader
XmlReader

Die XmlReader zu lesende Datei.

Gibt zurück

Wird XmlReadMode zum Lesen der Daten verwendet.

Beispiele

Im folgenden Beispiel wird zunächst eine einfache DataSet Zeile mit einer , zwei DataTableSpalten und zehn Zeilen erstellt. Das Schema und die DataSet Daten werden durch Aufrufen der WriteXml Methode auf den Datenträger geschrieben. Eine Sekunde DataSet wird erstellt, und die ReadXml Methode wird verwendet, um sie mit Schema und Daten auszufüllen.

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

Hinweise

Die ReadXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema in ein DataSet XML-Dokument zu lesen, während die ReadXmlSchema Methode nur das Schema liest. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML Überladungen, die den mode Parameter enthalten, und legen Sie den Wert auf ReadSchema.

Beachten Sie, dass das gleiche für die WriteXml bzw WriteXmlSchema . methoden gilt. Verwenden Sie die WriteXml Methode, um XML-Daten oder sowohl Schema- als auch Daten aus der DataSetXml-Datei zu schreiben. Verwenden Sie die WriteXmlSchema Methode, um nur das Schema zu schreiben.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Wenn ein Inlineschema angegeben wird, wird das Zeilenschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. die gleiche Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.

Wenn kein zeileninternes Schema angegeben wird, wird die relationale Struktur nach Bedarf entsprechend der Struktur des XML-Dokuments durch Schlussfolgerungen erweitert. Wenn das Schema nicht über Schlussfolgerungen erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.

Note

Das DataSet XML-Element wird nicht dem entsprechenden DataColumn XML-Element zugeordnet oder DataTable wenn rechtliche XML-Zeichen wie ("_") im serialisierten XML-Code escapen. Der DataSet selbst selbst escapet nur unzulässige XML-Zeichen in XML-Elementnamen und kann daher nur denselben verbrauchen. Wenn rechtliche Zeichen im XML-Elementnamen escaped sind, wird das Element während der Verarbeitung ignoriert.

Wenn das XML-Schema für ein DataSet Objekt enthält targetNamespace, werden die Daten möglicherweise nicht gelesen, und beim Aufrufen des Ladens ReadXml der XML-Datei, die DataSet Elemente ohne qualifizierenden Namespace enthält, werden Ausnahmen auftreten. Um nicht qualifizierte Elemente zu lesen, legen Sie elementFormDefault in Ihrem XML-Schema gleich "qualifiziert" fest, wie im folgenden Beispiel veranschaulicht.

<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 erbt von XmlReader.

Note

Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber unterschiedlichen Typs enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema durch Angabe XmlReadMode.ReadSchemain das DataSet Schema ReadXml zu lesen. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.

Weitere Informationen

Gilt für: