DataSet.ReadXml Metoda

Definicja

Odczytuje schemat XML i dane do elementu DataSet.

Przeciążenia

ReadXml(XmlReader, XmlReadMode)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych XmlReader elementów i XmlReadMode.

ReadXml(String, XmlReadMode)

Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku i XmlReadMode.

ReadXml(Stream, XmlReadMode)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych Stream elementów i XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych TextReader elementów i XmlReadMode.

ReadXml(String)

Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku.

ReadXml(TextReader)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego TextReaderelementu .

ReadXml(Stream)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego Streamelementu .

ReadXml(XmlReader)

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego XmlReaderelementu .

ReadXml(XmlReader, XmlReadMode)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych XmlReader elementów i 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

Element XmlReader , z którego mają być odczytywane.

mode
XmlReadMode

XmlReadMode Jedna z wartości.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML elementu DataSet zawiera targetNamespaceelement , dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(String, XmlReadMode)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku i 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

Nazwa pliku (w tym ścieżka), z której ma być odczytywany.

mode
XmlReadMode

XmlReadMode Jedna z wartości.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Wyjątki

FileIOPermission nie jest ustawiona na Readwartość .

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML elementu DataSet zawiera targetNamespaceelement , dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(Stream, XmlReadMode)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych Stream elementów i 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

Element Stream , z którego mają być odczytywane.

mode
XmlReadMode

XmlReadMode Jedna z wartości.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

To samo dotyczy WriteXml odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

W przypadku używania ReadXml elementu i ustawiania DiffgramXmlReadMode wartości na wartość zawartość elementu docelowego DataSet i oryginalnego DataSet może się różnić ze względu na sposób generowania i przetwarzania diffgramu. Aby uzyskać więcej informacji na temat diffgramów, zobacz DiffGrams.

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML dla elementu DataSet zawiera targetNamespace, dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(TextReader, XmlReadMode)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonych TextReader elementów i 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

Element TextReader , z którego mają być odczytywane.

mode
XmlReadMode

XmlReadMode Jedna z wartości.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML dla elementu DataSet zawiera targetNamespace, dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(String)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku.

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

Nazwa pliku (w tym ścieżka), z której ma być odczytywany.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Wyjątki

FileIOPermission nie jest ustawiona na Readwartość .

Przykłady

Poniższy przykład najpierw tworzy prosty z DataSet jednym DataTable, dwoma kolumnami i dziesięcioma wierszami. Schemat DataSet i dane są zapisywane na dysku przez wywołanie WriteXml metody . DataSet Drugi jest tworzony, a ReadXml metoda jest używana do wypełniania go schematem i danymi.

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

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML elementu DataSet zawiera targetNamespaceelement , dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(TextReader)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego TextReaderelementu .

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

Element TextReader , z którego ma być odczytywany schemat i dane.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Przykłady

Poniższy przykład najpierw tworzy prosty z DataSet jednym DataTable, dwoma kolumnami i dziesięcioma wierszami. Schemat DataSet i dane są zapisywane na dysku przez wywołanie WriteXml metody . DataSet Drugi jest tworzony, a ReadXml metoda jest używana do wypełniania go schematem i danymi.

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

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML dla elementu DataSet zawiera targetNamespace, dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Klasy dziedziczone z TextReader klasy obejmują StreamReader klasy i StringReader .

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(Stream)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego Streamelementu .

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

Obiekt pochodzący z klasy Stream.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Przykłady

Poniższy przykład najpierw tworzy prosty z DataSet jednym DataTable, dwoma kolumnami i dziesięcioma wierszami. Schemat DataSet i dane są zapisywane na dysku przez wywołanie WriteXml metody . DataSet Drugi jest tworzony, a ReadXml metoda jest używana do wypełniania go schematem i danymi.

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

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML dla elementu DataSet zawiera targetNamespace, dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

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

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy

ReadXml(XmlReader)

Źródło:
DataSet.cs
Źródło:
DataSet.cs
Źródło:
DataSet.cs

Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego XmlReaderelementu .

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

Element XmlReader , z którego mają być odczytywane.

Zwraca

Element XmlReadMode używany do odczytywania danych.

Przykłady

Poniższy przykład najpierw tworzy prosty z DataSet jednym DataTable, dwoma kolumnami i dziesięcioma wierszami. Schemat DataSet i dane są zapisywane na dysku przez wywołanie WriteXml metody . DataSet Drugi jest tworzony, a ReadXml metoda jest używana do wypełniania go schematem i danymi.

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

Uwagi

Metoda ReadXml umożliwia odczytywanie tylko danych lub zarówno danych, jak i schematu z DataSet dokumentu XML, natomiast ReadXmlSchema metoda odczytuje tylko schemat. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawiera mode parametr , i ustaw jego wartość na ReadSchema.

Należy pamiętać WriteXml , że to samo dotyczy odpowiednio metod i WriteXmlSchema . Aby zapisać dane XML lub zarówno schemat, jak i dane z klasy DataSet, użyj WriteXml metody . Aby napisać tylko schemat, użyj WriteXmlSchema metody .

Uwaga

Wartość InvalidOperationException zostanie wyrzucona, jeśli typ kolumny jest DataRow odczytywany z lub zapisywany w implementacji IDynamicMetaObjectProvider i nie implementuje elementu IXmlSerializable.

Jeśli zostanie określony schemat wbudowany, schemat wbudowany służy do rozszerzania istniejącej struktury relacyjnej przed załadowaniem danych. Jeśli występują jakiekolwiek konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej z różnymi typami danych), zgłaszany jest wyjątek.

Jeśli nie określono żadnego schematu wbudowanego, struktura relacyjna jest rozszerzana przez wnioskowanie, w razie potrzeby, zgodnie ze strukturą dokumentu XML. Jeśli nie można rozszerzyć schematu za pomocą wnioskowania w celu uwidocznienia wszystkich danych, zgłaszany jest wyjątek.

Uwaga

Obiekt DataSet nie kojarzy elementu XML z odpowiadającym DataColumn mu znakiem XML lub DataTable gdy znaki XML legalne, takie jak ("_") są zmieniane w serializowanym kodzie XML. Sam sam DataSet w sobie ucieka tylko niedozwolone znaki XML w nazwach elementów XML i dlatego może używać tylko tego samego. Po ucieczce znaków prawnych w nazwie elementu XML element jest ignorowany podczas przetwarzania.

Jeśli schemat XML elementu DataSet zawiera targetNamespaceelement , dane mogą nie być odczytywane i mogą wystąpić wyjątki podczas wywoływania ReadXml w celu załadowania pliku DataSet XML zawierającego elementy bez kwalifikowanej przestrzeni nazw. Aby odczytać niekwalifikowane elementy, ustaw elementFormDefault wartość równą "kwalifikowanej" w schemacie XML, jak pokazano w poniższym przykładzie.

<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 dziedziczy z XmlReader.

Uwaga

Jeśli schemat zawiera DataSet elementy o tej samej nazwie, ale inny typ, w tej samej przestrzeni nazw, podczas próby odczytania schematu do DataSetReadXml obiektu za pomocą zostanie zgłoszony wyjątek, określając XmlReadMode.ReadSchemawartość . Ten wyjątek nie występuje, jeśli używasz .NET Framework w wersji 1.0.

Zobacz też

Dotyczy