DataSet.ReadXml Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte schéma XML a data do DataSetsouboru .
Přetížení
ReadXml(XmlReader, XmlReadMode) |
Načte schéma a data XML do DataSet zadaného XmlReader a XmlReadMode. |
ReadXml(String, XmlReadMode) |
Načte schéma XML a data do zadaného DataSet souboru a XmlReadMode. |
ReadXml(Stream, XmlReadMode) |
Načte schéma a data XML do DataSet zadaného Stream a XmlReadMode. |
ReadXml(TextReader, XmlReadMode) |
Načte schéma a data XML do DataSet zadaného TextReader a XmlReadMode. |
ReadXml(String) |
Načte schéma XML a data do zadaného DataSet souboru. |
ReadXml(TextReader) |
Načte schéma XML a data do DataSet zadaného TextReadersouboru . |
ReadXml(Stream) | |
ReadXml(XmlReader) |
Načte schéma XML a data do DataSet zadaného XmlReadersouboru . |
ReadXml(XmlReader, XmlReadMode)
Načte schéma a data XML do DataSet zadaného XmlReader a 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
Parametry
- mode
- XmlReadMode
Jedna z XmlReadMode hodnot.
Návraty
Používá XmlReadMode
se ke čtení dat.
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí obsahuje targetNamespace
, data nemusí být čtená a při volání ReadXml do formátu DataSet XML, který obsahuje elementy bez opravňujícího oboru názvů, mohou nastat výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(String, XmlReadMode)
Načte schéma XML a data do zadaného DataSet souboru a 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
Parametry
- fileName
- String
Název souboru (včetně cesty), ze kterého se má číst.
- mode
- XmlReadMode
Jedna z XmlReadMode hodnot.
Návraty
Používá XmlReadMode
se ke čtení dat.
Výjimky
FileIOPermission není nastavena na Readhodnotu .
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí obsahuje targetNamespace
, data nemusí být čtená a při volání ReadXml do formátu DataSet XML, který obsahuje elementy bez opravňujícího oboru názvů, mohou nastat výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(Stream, XmlReadMode)
Načte schéma a data XML do DataSet zadaného Stream a 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
Parametry
- mode
- XmlReadMode
Jedna z XmlReadMode hodnot.
Návraty
Používá XmlReadMode
se ke čtení dat.
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Když použijete ReadXml a nastavíte XmlReadMode na Diffgram
, obsah cíle DataSet
a původní DataSet
se může lišit kvůli způsobu generování a zpracování diffgramu. Další informace o diffgramech najdete v tématu DiffGrams.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí targetNamespace
nemusí být čteno, data se nemusí číst a při volání ReadXml k načtení DataSet xml obsahující prvky, které nemají kvalifikující obor názvů, mohou narazit na výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(TextReader, XmlReadMode)
Načte schéma a data XML do DataSet zadaného TextReader a 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
Parametry
- reader
- TextReader
Od TextReader kterého se má číst.
- mode
- XmlReadMode
Jedna z XmlReadMode hodnot.
Návraty
Používá XmlReadMode
se ke čtení dat.
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí targetNamespace
nemusí být čteno, data se nemusí číst a při volání ReadXml k načtení DataSet xml obsahující prvky, které nemají kvalifikující obor názvů, mohou narazit na výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(String)
Načte schéma XML a data do zadaného DataSet souboru.
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
Parametry
- fileName
- String
Název souboru (včetně cesty), ze kterého se má číst.
Návraty
Používá XmlReadMode
se ke čtení dat.
Výjimky
FileIOPermission není nastavena na Readhodnotu .
Příklady
Následující příklad nejprve vytvoří jednoduchý DataSet s jedním DataTable, dvěma sloupci a deseti řádky. Schéma DataSet a data se zapisují na disk vyvoláním WriteXml metody. Vytvoří se sekunda DataSet ReadXml a metoda se použije k jeho vyplnění schématem a daty.
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
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí obsahuje targetNamespace
, data nemusí být čtená a při volání ReadXml do formátu DataSet XML, který obsahuje elementy bez opravňujícího oboru názvů, mohou nastat výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(TextReader)
Načte schéma XML a data do DataSet zadaného TextReadersouboru .
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
Parametry
- reader
- TextReader
Od TextReader
kterého se má schéma a data číst.
Návraty
Používá XmlReadMode se ke čtení dat.
Příklady
Následující příklad nejprve vytvoří jednoduchý DataSet s jedním DataTable, dvěma sloupci a deseti řádky. Schéma DataSet a data se zapisují na disk vyvoláním WriteXml metody. Vytvoří se sekunda DataSet ReadXml a metoda se použije k jeho vyplnění schématem a daty.
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
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí targetNamespace
nemusí být čteno, data se nemusí číst a při volání ReadXml k načtení DataSet xml obsahující prvky, které nemají kvalifikující obor názvů, mohou narazit na výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Třídy, které dědí z TextReader třídy, zahrnují StreamReader třídy a StringReader třídy.
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(Stream)
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
Parametry
Návraty
Používá XmlReadMode se ke čtení dat.
Příklady
Následující příklad nejprve vytvoří jednoduchý DataSet s jedním DataTable, dvěma sloupci a deseti řádky. Schéma DataSet a data se zapisují na disk vyvoláním WriteXml metody. Vytvoří se sekunda DataSet ReadXml a metoda se použije k jeho vyplnění schématem a daty.
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
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí targetNamespace
nemusí být čteno, data se nemusí číst a při volání ReadXml k načtení DataSet xml obsahující prvky, které nemají kvalifikující obor názvů, mohou narazit na výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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>
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.
Viz také
Platí pro
ReadXml(XmlReader)
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
Parametry
Návraty
Používá XmlReadMode
se ke čtení dat.
Příklady
Následující příklad nejprve vytvoří jednoduchý DataSet s jedním DataTable, dvěma sloupci a deseti řádky. Schéma DataSet a data se zapisují na disk vyvoláním WriteXml metody. Vytvoří se sekunda DataSet ReadXml a metoda se použije k jeho vyplnění schématem a daty.
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
Poznámky
Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma do DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jednu z ReadXML
přetížení, která obsahuje mode
parametr, a nastavte jeho hodnotu na ReadSchema
.
Všimněte si, že totéž platí pro WriteXml metody a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z metody DataSet
použijte metodu WriteXml
. K zápisu pouze schématu použijte metodu WriteXmlSchema
.
Poznámka
Vyvolá InvalidOperationException se, pokud typ sloupce, který DataRow
se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.
Pokud je zadáno vložené schéma, rozšiřuje toto vložené schéma stávající relační strukturu před načtením dat. Pokud se vyskytnou jakékoli konflikty (například stejný sloupec je ve stejné tabulce definován s použitím různých typů dat), je vyvolána výjimka.
Pokud není zadáno žádné vložené schéma, rozšiřuje se relační struktura v případě potřeby prostřednictvím odvození podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvození tak, aby byla vystavena všechna data, je vyvolána výjimka.
Poznámka
Přidružuje DataSet
element XML k odpovídajícímu DataColumn
prvku nebo DataTable
když jsou v serializovaném XML uchycené znaky XML jako ("_"). Samotný DataSet
pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může využívat pouze stejné. Pokud jsou povolené znaky v názvu elementu XML uvozeny řídicími znaky, je element při zpracování ignorován.
Pokud schéma XML pro DataSet zahrnutí obsahuje targetNamespace
, data nemusí být čtená a při volání ReadXml do formátu DataSet XML, který obsahuje elementy bez opravňujícího oboru názvů, mohou nastat výjimky. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault
ve schématu XML hodnotu "kvalifikovaná", jak ukazuje následující příklad.
<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 dědí z XmlReader.
Poznámka
Pokud schéma pro váš DataSet název obsahuje prvky stejného názvu, ale jiný typ ve stejném oboru názvů, vyvolá se výjimka při pokusu o načtení schématu DataSet do s ReadXml použitím zadání XmlReadMode.ReadSchema
. K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.