DataSet.ReadXml Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

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

Přetížení

Name	Description
ReadXml(XmlReader, XmlReadMode)	Načte schéma XML a data 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 XML a data do DataSet zadaného Stream a XmlReadMode.
ReadXml(TextReader, XmlReadMode)	Načte schéma XML a data 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 TextReader.
ReadXml(Stream)	Načte schéma XML a data do DataSet zadaného Stream.
ReadXml(XmlReader)	Načte schéma XML a data do DataSet zadaného XmlReader.

ReadXml(XmlReader, XmlReadMode)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného XmlReader a XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

Ze XmlReader kterého se má číst.

mode

XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Poznámky

Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující elementy, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(String, XmlReadMode)

Zdroj:

DataSet.cs

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

SecurityException

FileIOPermission není nastavena na Readhodnotu .

Poznámky

Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující elementy, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(Stream, XmlReadMode)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného Stream a XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

Ze Stream kterého se má číst.

mode

XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Poznámky

Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Při použití ReadXml a nastavení 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.

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující prvky, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(TextReader, XmlReadMode)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného TextReader a XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

Ze TextReader kterého se má číst.

mode

XmlReadMode

Jedna z XmlReadMode hodnot.

Návraty

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Poznámky

Metoda ReadXml poskytuje způsob, jak číst pouze data, nebo data i schéma z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující prvky, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(String)

Zdroj:

DataSet.cs

Načte schéma XML a data do zadaného DataSet souboru.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

SecurityException

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 DataSetReadXml a metoda se použije k 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 z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující elementy, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(TextReader)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

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 DataSetReadXml a metoda se použije k 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 z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující prvky, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

Třídy, které dědí z TextReader třídy, zahrnují třídy StreamReader a StringReader třídy.

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET

ReadXml(Stream)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Public Function ReadXml (stream As Stream) As XmlReadMode

Parametry

stream

Stream

Objekt, který je odvozen od Stream.

Návraty

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

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 DataSetReadXml a metoda se použije k 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 z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující prvky, které nemají opravňující obor názvů, mohou narazit na výjimky. 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>

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• ReadXmlSchema(XmlReader)
• WriteXml(Stream)
• WriteXmlSchema(Stream)
• Použití datových sad v ADO.NET

ReadXml(XmlReader)

Zdroj:

DataSet.cs

Načte schéma XML a data do DataSet zadaného XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode

Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parametry

reader

XmlReader

Ze XmlReader kterého se má číst.

Návraty

XmlReadMode

Používá XmlReadMode se ke čtení dat.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

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 DataSetReadXml a metoda se použije k 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 z DataSet dokumentu XML, zatímco ReadXmlSchema metoda čte pouze schéma. Ke čtení dat i schématu ReadXML použijte jedno z přetížení, které zahrnuje mode parametr, a nastavte jeho hodnotu na ReadSchema.

Všimněte si, že totéž platí pro metody WriteXml a WriteXmlSchema metody. K zápisu dat XML nebo schématu i dat z této DataSetmetody použijte metodu WriteXml . K zápisu pouze schématu použijte metodu WriteXmlSchema .

Note

Bude InvalidOperationException vyvolána, pokud typ sloupce, který DataRow se čte z nebo zapisuje do implementace IDynamicMetaObjectProvider a neimplementuje IXmlSerializable.

Pokud je zadáno vložené schéma, použije se in-line schéma k rozšíření existující relační struktury před načtením dat. Pokud dojde ke konfliktům (například stejný sloupec ve stejné tabulce definované s různými datovými typy), vyvolá se výjimka.

Pokud není zadáno žádné vložené schéma, relační struktura se podle potřeby rozšíří prostřednictvím odvozování podle struktury dokumentu XML. Pokud schéma nelze rozšířit prostřednictvím odvozování, aby bylo možné zveřejnit všechna data, je vyvolána výjimka.

Note

Nepřidružuje DataSet xml element k odpovídajícímu DataColumn nebo DataTable když jsou právní znaky XML jako ("_") řídicí znak v serializovaném XML. Samotný DataSet samotný řídicí znak v názvech elementů XML pouze umistuje neplatné znaky XML, a proto může využívat pouze stejné. Pokud jsou v názvu elementu XML uniknuty právní znaky, je prvek při zpracování ignorován.

Pokud schéma XML pro DataSet zahrnutí targetNamespace, data nemusí být přečtená a při volání ReadXml pro načtení DataSet xml obsahující elementy, které nemají opravňující obor názvů, mohou narazit na výjimky. Chcete-li čí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>

System.Xml.XmlTextReader dědí z XmlReader.

Note

Pokud schéma pro vaše DataSet obsahuje prvky se stejným názvem, ale jiný typ, ve stejném oboru názvů, je vyvolán výjimka při pokusu o načtení schématu DataSet do s ReadXml zadáním XmlReadMode.ReadSchema. K této výjimce nedojde, pokud používáte .NET Framework verze 1.0.

Viz také

• Použití datových sad v ADO.NET