DataSet.ReadXml Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest ein XML-Schema und XML-Daten in das DataSet.
Überlädt
ReadXml(XmlReader, XmlReadMode) |
Liest mit dem angegebenen DataSet und im angegebenen XmlReader das XML-Schema und die XML-Daten in das XmlReadMode. |
ReadXml(String, XmlReadMode) |
Liest mit der angegebenen Datei und im angegebenen DataSet das XML-Schema und die XML-Daten in das XmlReadMode. |
ReadXml(Stream, XmlReadMode) |
Liest mit dem angegebenen DataSet und im angegebenen Stream das XML-Schema und die XML-Daten in das XmlReadMode. |
ReadXml(TextReader, XmlReadMode) |
Liest mit dem angegebenen DataSet und im angegebenen TextReader das XML-Schema und die XML-Daten in das XmlReadMode. |
ReadXml(String) |
Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das DataSet. |
ReadXml(TextReader) |
Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die TextReader. |
ReadXml(Stream) |
Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die Stream. |
ReadXml(XmlReader) |
Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die XmlReader. |
ReadXml(XmlReader, XmlReadMode)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mit dem angegebenen DataSet und im angegebenen XmlReader das XML-Schema und die XML-Daten in das 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);
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
- mode
- XmlReadMode
Einer der XmlReadMode-Werte.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Hinweise
Die ReadXml -Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für einen DataSet einen targetNamespace
enthält, werden Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten, wenn ReadXml Sie aufrufen, um den mit XML zu laden, der DataSet Elemente ohne qualifizierten Namespace enthält. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(String, XmlReadMode)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mit der angegebenen Datei und im angegebenen DataSet das XML-Schema und die XML-Daten in das 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 Name der Datei, aus der gelesen werden soll, einschließlich des Pfades.
- mode
- XmlReadMode
Einer der XmlReadMode-Werte.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Ausnahmen
FileIOPermission ist nicht auf Read festgelegt.
Hinweise
Die ReadXml -Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für einen DataSet einen targetNamespace
enthält, werden Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten, wenn ReadXml Sie aufrufen, um den mit XML zu laden, der DataSet Elemente ohne qualifizierten Namespace enthält. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(Stream, XmlReadMode)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mit dem angegebenen DataSet und im angegebenen Stream das XML-Schema und die XML-Daten in das 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);
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
- mode
- XmlReadMode
Einer der XmlReadMode-Werte.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Hinweise
Die ReadXml -Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Gleiches gilt für die WriteXml Methoden und WriteXmlSchema . Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Wenn Sie verwenden ReadXml und auf Diffgram
festlegenXmlReadMode, können sich der Inhalt des Ziels DataSet
und des Originals DataSet
unterscheiden, da das Diffgram generiert und verarbeitet wird. Weitere Informationen zu Diffgrams finden Sie unter DiffGrams.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für ein DataSet enthält targetNamespace
, werden Daten möglicherweise nicht gelesen, und beim Aufrufen ReadXml von Mit XML, das DataSet Elemente ohne qualifizierten Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(TextReader, XmlReadMode)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mit dem angegebenen DataSet und im angegebenen TextReader das XML-Schema und die XML-Daten in das 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);
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
Der TextReader, aus dem gelesen werden soll.
- mode
- XmlReadMode
Einer der XmlReadMode-Werte.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Hinweise
Die ReadXml -Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für ein DataSet enthält targetNamespace
, werden Daten möglicherweise nicht gelesen, und beim Aufrufen ReadXml von Mit XML, das DataSet Elemente ohne qualifizierten Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(String)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das DataSet.
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 Name der Datei, aus der gelesen werden soll, einschließlich des Pfades.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Ausnahmen
FileIOPermission ist nicht auf Read festgelegt.
Beispiele
Im folgenden Beispiel wird zunächst ein einfaches DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das DataSet Schema und die Daten werden durch Aufrufen der -Methode auf den WriteXml Datenträger geschrieben. Eine zweite DataSet wird erstellt, und die ReadXml -Methode wird verwendet, um sie mit Schema und Daten zu fü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 aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für einen DataSet einen targetNamespace
enthält, werden Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten, wenn ReadXml Sie aufrufen, um den mit XML zu laden, der DataSet Elemente ohne qualifizierten Namespace enthält. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(TextReader)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die TextReader.
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
Parameter
- reader
- TextReader
Der TextReader
, aus dem das Schema und die Daten gelesen werden sollen.
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode.
Beispiele
Im folgenden Beispiel wird zunächst ein einfaches DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das DataSet Schema und die Daten werden durch Aufrufen der -Methode auf den WriteXml Datenträger geschrieben. Eine zweite DataSet wird erstellt, und die ReadXml -Methode wird verwendet, um sie mit Schema und Daten zu fü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 aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für ein DataSet enthält targetNamespace
, werden Daten möglicherweise nicht gelesen, und beim Aufrufen ReadXml von Mit XML, das DataSet Elemente ohne qualifizierten Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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, umfassen die StreamReader - und StringReader -Klasse.
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(Stream)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
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
Parameter
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode.
Beispiele
Im folgenden Beispiel wird zunächst ein einfaches DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das DataSet Schema und die Daten werden durch Aufrufen der -Methode auf den WriteXml Datenträger geschrieben. Eine zweite DataSet wird erstellt, und die ReadXml -Methode wird verwendet, um sie mit Schema und Daten zu fü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 aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für ein DataSet enthält targetNamespace
, werden Daten möglicherweise nicht gelesen, und beim Aufrufen ReadXml von Mit XML, das DataSet Elemente ohne qualifizierten Namespace enthält, treten möglicherweise Ausnahmen auf. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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>
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.
Weitere Informationen
Gilt für:
ReadXml(XmlReader)
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
- Quelle:
- DataSet.cs
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
Parameter
Gibt zurück
Der zum Lesen der Daten verwendete XmlReadMode
.
Beispiele
Im folgenden Beispiel wird zunächst ein einfaches DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das DataSet Schema und die Daten werden durch Aufrufen der -Methode auf den WriteXml Datenträger geschrieben. Eine zweite DataSet wird erstellt, und die ReadXml -Methode wird verwendet, um sie mit Schema und Daten zu fü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 aus einem DataSet XML-Dokument zu lesen, während die ReadXmlSchema -Methode nur das Schema liest. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML
Überladungen, die enthält die mode
Parameter, und legen Sie dessen Wert auf ReadSchema
.
Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw. Schreiben von XML-Daten oder Schema und Daten aus der DataSet
, verwenden Sie die WriteXml
Methode. Verwenden Sie die -Methode, um nur das WriteXmlSchema
Schema zu schreiben.
Hinweis
Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow
aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.
Wenn ein Inlineschema angegeben wird, wird das Inlineschema verwendet, um die vorhandene relationale Struktur vor dem Laden der Daten zu erweitern. Wenn Konflikte auftreten (z. B. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert ist), wird eine Ausnahme ausgelöst.
Wenn kein Inlineschema angegeben wird, wird die relationale Struktur entsprechend der Struktur des XML-Dokuments bei Bedarf durch Rückschluss erweitert. Wenn das Schema nicht über Rückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.
Hinweis
Das DataSet
ordnet einem XML-Element keine entsprechenden DataColumn
oder DataTable
zu, wenn rechtliche XML-Zeichen wie ("_") in der serialisierten XML-Datei mit Escapezeichen versehen werden. Die DataSet
selbst escapet nur ungültige XML-Zeichen in XML-Elementnamen und kann daher nur dieselben verwenden. Wenn rechtliche Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element während der Verarbeitung ignoriert.
Wenn das XML-Schema für einen DataSet einen targetNamespace
enthält, werden Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten, wenn ReadXml Sie aufrufen, um den mit XML zu laden, der DataSet Elemente ohne qualifizierten Namespace enthält. Um nicht qualifizierte Elemente zu lesen, legen Sie in Ihrem XML-Schema gleich "qualifiziert" fest elementFormDefault
, 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.
Hinweis
Wenn das Schema für Ihre DataSet Elemente mit demselben Namen, aber einem anderen Typ enthält, wird im selben Namespace eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema in das DataSetReadXml mit zu lesen, indem Sie angeben XmlReadMode.ReadSchema
. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1.0 verwenden.