DataSet.ReadXml Metoda

Definice

Načte schéma a data XML do objektu DataSet.

Přetížení

ReadXml(XmlReader, XmlReadMode)

Načte schéma a data XML do objektu DataSet pomocí zadaných XmlReader a XmlReadMode.

ReadXml(String, XmlReadMode)

Načte schéma a data XML do objektu DataSet pomocí zadaného souboru a XmlReadMode.

ReadXml(Stream, XmlReadMode)

Načte schéma a data XML do objektu DataSet pomocí zadaných Stream a XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Načte schéma a data XML do objektu DataSet pomocí zadaných TextReader a XmlReadMode.

ReadXml(String)

Pomocí zadaného souboru načte schéma a data DataSet XML.

ReadXml(TextReader)

Načte schéma XML a data do objektu DataSet pomocí zadaného TextReaderobjektu .

ReadXml(Stream)

Načte schéma XML a data do objektu DataSet pomocí zadaného Streamobjektu .

ReadXml(XmlReader)

Načte schéma XML a data do objektu DataSet pomocí zadaného XmlReaderobjektu .

ReadXml(XmlReader, XmlReadMode)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma a data XML do objektu DataSet pomocí zadaných 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

reader
XmlReader

Hodnota XmlReader , ze které se má číst.

mode
XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

Slouží XmlReadMode ke čtení dat.

Poznámky

Metoda ReadXml poskytuje způsob, jak číst buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 DataSettargetNamespaceobsahuje , data nemusí být načtena a při volání ReadXml pro načtení DataSet pomocí XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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 obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma a data XML do objektu DataSet pomocí zadaného 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

Slouží XmlReadMode ke čtení dat.

Výjimky

FileIOPermission není nastavená na Readhodnotu .

Poznámky

Metoda ReadXml poskytuje způsob, jak číst buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 DataSettargetNamespaceobsahuje , data nemusí být načtena a při volání ReadXml pro načtení DataSet pomocí XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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 obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma a data XML do objektu DataSet pomocí zadaných 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

stream
Stream

Hodnota Stream , ze které se má číst.

mode
XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

Slouží XmlReadMode ke čtení dat.

Poznámky

Metoda ReadXml poskytuje způsob, jak číst buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno z ReadXML přetížení, které obsahuje mode parametr , a nastavte jeho hodnotu na ReadSchema.

Totéž platí pro WriteXml metody a WriteXmlSchema v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Pokud použijete ReadXml a nastavíte XmlReadMode na Diffgram, obsah cíle DataSet a originálu DataSet se může lišit z důvodu generování a zpracování diffgramu. Další informace o diffgramech najdete v tématu DiffGrams.

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 zahrnuje targetNamespace, data nemusí být načtena a při volání ReadXml za účelem načtení DataSet s XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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 obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma a data XML do objektu DataSet pomocí zadaných 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

Hodnota TextReader , ze které se má číst.

mode
XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

Slouží XmlReadMode ke čtení dat.

Poznámky

Metoda ReadXml poskytuje způsob, jak číst buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 zahrnuje targetNamespace, data nemusí být načtena a při volání ReadXml za účelem načtení DataSet s XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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 obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Pomocí zadaného souboru načte schéma a data DataSet XML.

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

Slouží XmlReadMode ke čtení dat.

Výjimky

FileIOPermission není nastavená na Readhodnotu .

Příklady

Následující příklad nejprve vytvoří jednoduchý DataSet objekt 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 druhá DataSet a ReadXml metoda se použije k vyplnění schématu 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 buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 DataSettargetNamespaceobsahuje , data nemusí být načtena a při volání ReadXml pro načtení DataSet pomocí XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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 obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma XML a data do objektu DataSet pomocí zadaného TextReaderobjektu .

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

Ze TextReader kterého se má číst schéma a data.

Návraty

Slouží XmlReadMode ke čtení dat.

Příklady

Následující příklad nejprve vytvoří jednoduchý DataSet objekt 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 druhá DataSet a ReadXml metoda se použije k vyplnění schématu 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 buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 zahrnuje targetNamespace, data nemusí být načtena a při volání ReadXml za účelem načtení DataSet s XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Chcete-li číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na 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í TextReader z třídy, StreamReader zahrnují třídy a StringReader .

Poznámka

Pokud schéma pro váš DataSet obsahuje prvky se stejným názvem, ale jiným typem, ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSetReadXml s zadáním 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)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma XML a data do objektu DataSet pomocí zadaného Streamobjektu .

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

stream
Stream

Objekt, který je odvozen z Stream.

Návraty

Slouží XmlReadMode ke čtení dat.

Příklady

Následující příklad nejprve vytvoří jednoduchý DataSet objekt 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 druhá DataSet a ReadXml metoda se použije k vyplnění schématu 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 buď data pouze, nebo jak data, tak schéma do DataSet z dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . Pokud chcete napsat pouze schéma, použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu DataRow , ze kterého se čte nebo do kterého se zapisuje, implementuje 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

Nepřidružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky jako ("_") jsou řídicí v serializované XML. Sám DataSet o sobě pouze uchytá neplatné znaky XML v názvech elementů XML, a proto může použí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 zahrnuje targetNamespace, data nemusí být načtena a při volání ReadXml za účelem načtení DataSet s XML, který obsahuje elementy bez opravňujícího oboru názvů, může dojít k výjimkám. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML hodnotu "qualified", 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 obsahuje DataSet prvky stejného názvu, ale jiného typu ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSet pole s ReadXml zadáním XmlReadMode.ReadSchemavýjimky . K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.

Viz také

Platí pro

ReadXml(XmlReader)

Zdroj:
DataSet.cs
Zdroj:
DataSet.cs
Zdroj:
DataSet.cs

Načte schéma XML a data do objektu DataSet pomocí zadaného XmlReaderobjektu .

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

reader
XmlReader

Hodnota XmlReader , ze které se má číst.

Návraty

Slouží XmlReadMode 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 jsou zapsány na disk vyvoláním WriteXml metody. Vytvoří se sekunda DataSetReadXml a metoda se použije k jejímu 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 buď pouze data, nebo jak data a schéma z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Pokud chcete číst data i schéma, použijte jedno 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 v uvedeném pořadí. K zápisu dat XML nebo schématu i dat z objektu DataSetpoužijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Poznámka

Vyvolá InvalidOperationException se, pokud typ sloupce v objektu, který DataRow se čte z nebo zapisuje IDynamicMetaObjectProvider do implementace, 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

Nesdružuje DataSet element XML s jeho odpovídající DataColumn nebo DataTable když právní XML znaky, jako je ("_") jsou řídicí v serializované XML. Sama DataSet o sobě pouze uniká 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 objekt obsahuje targetNamespace, data se nemusí číst a při volání ReadXml pro načtení DataSet souboru XML, který obsahuje prvky bez opravňujícího oboru názvů, může dojít k výjimkám. Pokud chcete číst nekvalifikované elementy, nastavte elementFormDefault ve schématu XML na hodnotu "qualified", 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 obsahuje DataSet prvky stejného názvu, ale jiného typu ve stejném oboru názvů, vyvolá se při pokusu o načtení schématu do DataSet pole s ReadXml zadáním XmlReadMode.ReadSchemavýjimky . K této výjimce nedochází, používáte-li rozhraní .NET Framework verze 1.0.

Viz také

Platí pro