Laden eines 'DataSet' aus XML (ADO.NET)

Aktualisiert: November 2007

Der Inhalt eines ADO.NET-DataSet kann aus einem XML-Stream oder einem XML-Dokument erstellt werden. Außerdem können Sie mit .NET Framework größtenteils festlegen, welche Informationen aus der XML-Quelle geladen werden sollen und wie das Schema oder die relationale Struktur des DataSet erstellt werden soll.

Verwenden Sie zum Füllen eines DataSet mit Daten aus einer XML-Quelle die ReadXml-Methode des DataSet-Objekts. Die ReadXml-Methode liest Daten aus einer Datei, einem Stream oder einem XmlReader und verwendet die Quelle der XML-Daten sowie ein optionales XmlReadMode-Argument als Argumente. (Weitere Informationen zum XmlReader finden Sie unter Lesen von XML-Daten mit dem "XmlTextReader".) Die ReadXml-Methode liest den Inhalt des XML-Streams oder des XML-Dokuments und füllt das DataSet mit Daten. In Abhängigkeit vom angegebenen XmlReadMode und vom Vorhandensein eines relationalen Schemas erstellt die Methode außerdem das relationale Schema des DataSet.

In der folgenden Tabelle werden die Optionen für das XmlReadMode-Argument beschrieben.

Hinweis:
Wenn Sie einen XmlReader an die ReadXml-Methode übergeben, die sich innerhalb eines XML-Dokuments befindet, liest ReadXml bis zum nächsten Elementknoten, behandelt diesen als Stammelement und liest dann nur bis zum Ende des Elementknotens. Dies trifft nicht zu, wenn Sie XmlReadMode.Fragment verwenden.

DTD-Entitäten

Bei einem XML-Dokument mit Entitäten, die in einem DTD-Schema (Document Type Definition) definiert sind, wird eine Ausnahme ausgelöst, wenn Sie versuchen, ein DataSet zu laden, indem Sie einen Dateinamen, einen Stream oder einen nicht validierten XmlReader an ReadXml übergeben. Erstellen Sie stattdessen einen XmlValidatingReader, bei dem EntityHandling auf EntityHandling.ExpandEntities festgelegt ist, und übergeben Sie anschließend den XmlValidatingReader an ReadXml. Der XmlValidatingReader erweitert die Entitäten, bevor er vom DataSet gelesen wird.

In den folgenden Codebeispielen wird dargestellt, wie ein DataSet aus einem XML-Stream geladen wird. Im ersten Beispiel wird ein Dateiname an die ReadXml-Methode übergeben. Im zweiten Beispiel wird eine Zeichenfolge mit XML-Daten mithilfe eines StringReader geladen.

Dim dataSet As DataSet = New DataSet
dataSet.ReadXml("input.xml", XmlReadMode.ReadSchema)

DataSet dataSet = new DataSet();
dataSet.ReadXml("input.xml", XmlReadMode.ReadSchema);

Dim dataSet As DataSet = New DataSet
Dim dataTable As DataTable = New DataTable("table1")
dataTable.Columns.Add("col1", Type.GetType("System.String"))
dataSet.Tables.Add(dataTable)

Dim xmlData As String = "<XmlDS><table1><col1>Value1</col1></table1><table1><col1>Value2</col1></table1></XmlDS>"

Dim xmlSR As System.IO.StringReader = New System.IO.StringReader(xmlData)

dataSet.ReadXml(xmlSR, XmlReadMode.IgnoreSchema)

DataSet dataSet = new DataSet();
DataTable dataTable = new DataTable("table1");
dataTable.Columns.Add("col1", typeof(string));
dataSet.Tables.Add(dataTable);

string xmlData = "<XmlDS><table1><col1>Value1</col1></table1><table1><col1>Value2</col1></table1></XmlDS>";

System.IO.StringReader xmlSR = new System.IO.StringReader(xmlData);

dataSet.ReadXml(xmlSR, XmlReadMode.IgnoreSchema);

Hinweis:

Wenn für das Laden einer sehr großen Datei ReadXml aufgerufen wird, führt dies möglicherweise zu einem Leistungsabfall. Damit ReadXml mit optimaler Effizienz verwendet werden kann, rufen Sie bei einer großen Datei zunächst die BeginLoadData-Methode für jede Tabelle im DataSet auf, und rufen Sie anschließend ReadXml auf. Rufen Sie zum Schluss EndLoadData für jede Tabelle im DataSet auf. Dies wird im folgenden Beispiel dargestellt.

Dim dataTable As DataTable

For Each dataTable In dataSet.Tables
   dataTable.BeginLoadData()
Next

dataSet.ReadXml("file.xml")

For Each dataTable in dataSet.Tables
   dataTable.EndLoadData()
Next

foreach (DataTable dataTable in dataSet.Tables)
   dataTable.BeginLoadData();

dataSet.ReadXml("file.xml"); 

foreach (DataTable dataTable in dataSet.Tables)
   dataTable.EndLoadData();

Hinweis:

Wenn zum XSD-Schema für das DataSet ein targetNamespace gehört, werden die Daten möglicherweise nicht gelesen. Außerdem können Ausnahmen ausgelöst werden, wenn Sie ReadXml zum Laden des DataSet mit XML aufrufen, das Elemente ohne qualifizierenden Namespace enthält. Damit in diesem Fall nicht qualifizierte Elemente gelesen werden können, legen Sie im XSD-Schema elementFormDefault auf qualified fest. Beispiel:

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

Zusammenführen von Daten aus XML-Dokumenten

Wenn das DataSet bereits Daten enthält, werden die neuen Daten aus der XML-Quelle den im DataSet bereits vorhandenen Daten hinzugefügt. ReadXml fügt keine Zeileninformationen mit übereinstimmenden Primärschlüsseln aus dem XML-Dokument in das DataSet ein. Wenn vorhandene Zeileninformationen mit neuen XML-Informationen überschrieben werden sollen, müssen Sie mit ReadXml zunächst ein neues DataSet erstellen. Führen Sie anschließend einen Merge-Vorgang aus, um das neue DataSet mit dem vorhandenen DataSet zusammenzuführen. Wenn Sie ein DiffGram mit ReadXML laden und XmlReadMode auf DiffGram festgelegt ist, werden die Zeilen mit identischem Bezeichner zusammengeführt.

Siehe auch

Konzepte

DiffGrams (ADO.NET)

Laden von 'DataSet'-Schemainformationen aus XML (ADO.NET)

Referenz

DataSet.Merge

Weitere Ressourcen

Verwenden von XML in einem 'DataSet' (ADO.NET)

Ableiten einer relationalen 'DataSet'-Struktur aus einem XML-Schema (XSD)

Herleiten der relationalen 'DataSet'-Struktur aus XML (ADO.NET)

'DataSets', 'DataTables' und 'DataViews' (ADO.NET)