DataSet.ReadXml Metode

Definisi

Membaca skema XML dan data ke DataSetdalam .

Overload

ReadXml(XmlReader, XmlReadMode)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan XmlReader dan XmlReadMode.

ReadXml(String, XmlReadMode)

Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan dan XmlReadMode.

ReadXml(Stream, XmlReadMode)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan Stream dan XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan TextReader dan XmlReadMode.

ReadXml(String)

Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan.

ReadXml(TextReader)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan TextReader.

ReadXml(Stream)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan Stream.

ReadXml(XmlReader)

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan XmlReader.

ReadXml(XmlReader, XmlReadMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan XmlReader dan 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

Parameter

reader
XmlReader

dari XmlReader mana untuk membaca.

mode
XmlReadMode

Salah XmlReadMode satu nilai.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis hanya skema, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML serial. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(String, XmlReadMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan dan 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

Parameter

fileName
String

Nama file (termasuk jalur) tempat membaca.

mode
XmlReadMode

Salah XmlReadMode satu nilai.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Pengecualian

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis hanya skema, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML serial. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(Stream, XmlReadMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema XML dan data ke DataSet dalam menggunakan yang ditentukan Stream dan 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

Parameter

stream
Stream

dari Stream mana untuk membaca.

mode
XmlReadMode

Salah XmlReadMode satu nilai.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema . Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis hanya skema, gunakan WriteXmlSchema metode .

Catatan

Saat Anda menggunakan ReadXml dan Anda mengatur XmlReadMode ke Diffgram, konten target DataSet dan aslinya DataSet mungkin berbeda karena bagaimana diffgram dihasilkan dan diproses. Untuk informasi selengkapnya tentang diffgram, lihat DiffGrams.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML serial. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(TextReader, XmlReadMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema dan data XML ke DataSet dalam menggunakan dan XmlReadModeyang ditentukanTextReader.

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

Parameter

reader
TextReader

dari TextReader mana untuk membaca.

mode
XmlReadMode

Salah XmlReadMode satu nilai.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis skema saja, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML berseri. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(String)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan.

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

Parameter

fileName
String

Nama file (termasuk jalur) tempat membaca.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Pengecualian

Contoh

Contoh berikut pertama-tama membuat sederhana DataSet dengan satu DataTable, dua kolom, dan sepuluh baris. DataSet Skema dan data ditulis ke disk dengan memanggil WriteXml metode . DataSet Detik dibuat dan ReadXml metode digunakan untuk mengisinya dengan skema dan data.

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

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis skema saja, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML berseri. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(TextReader)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan TextReader.

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

Parameter

reader
TextReader

TextReader dari mana untuk membaca skema dan data.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Contoh

Contoh berikut pertama-tama membuat sederhana DataSet dengan satu DataTable, dua kolom, dan sepuluh baris. DataSet Skema dan data ditulis ke disk dengan memanggil WriteXml metode . DataSet Detik dibuat dan ReadXml metode digunakan untuk mengisinya dengan skema dan data.

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

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis skema saja, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML berseri. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

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

Kelas yang diwarisi dari TextReader kelas mencakup StreamReader kelas dan StringReader .

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(Stream)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream) As XmlReadMode

Parameter

stream
Stream

Objek yang berasal dari Stream.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Contoh

Contoh berikut pertama-tama membuat sederhana DataSet dengan satu DataTable, dua kolom, dan sepuluh baris. DataSet Skema dan data ditulis ke disk dengan memanggil WriteXml metode . DataSet Detik dibuat dan ReadXml metode digunakan untuk mengisinya dengan skema dan data.

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

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis skema saja, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML berseri. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda, seperti yang ditunjukkan contoh berikut.

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

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk

ReadXml(XmlReader)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parameter

reader
XmlReader

dari XmlReader mana untuk membaca.

Mengembalikan

yang XmlReadMode digunakan untuk membaca data.

Contoh

Contoh berikut pertama-tama membuat sederhana DataSet dengan satu DataTable, dua kolom, dan sepuluh baris. DataSet Skema dan data ditulis ke disk dengan memanggil WriteXml metode . DataSet Detik dibuat dan ReadXml metode digunakan untuk mengisinya dengan skema dan data.

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

Keterangan

Metode ini ReadXml menyediakan cara untuk membaca data saja, atau data dan skema ke dalam DataSet dari dokumen XML, sedangkan ReadXmlSchema metode hanya membaca skema. Untuk membaca data dan skema, gunakan salah ReadXML satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke ReadSchema.

Perhatikan bahwa hal yang sama berlaku untuk WriteXml metode dan WriteXmlSchema , masing-masing. Untuk menulis data XML, atau skema dan data dari DataSet, gunakan WriteXml metode . Untuk menulis skema saja, gunakan WriteXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Jika skema in-line ditentukan, skema in-line digunakan untuk memperluas struktur relasional yang ada sebelum memuat data. Jika ada konflik (misalnya, kolom yang sama dalam tabel yang sama yang ditentukan dengan jenis data yang berbeda) pengecualian akan dimunculkan.

Jika tidak ada skema in-line yang ditentukan, struktur relasional diperluas melalui inferensi, seperlunya, sesuai dengan struktur dokumen XML. Jika skema tidak dapat diperluas melalui inferensi untuk mengekspos semua data, pengecualian akan dimunculkan.

Catatan

DataSet tidak mengaitkan elemen XML dengan yang sesuai DataColumn atau DataTable ketika karakter XML hukum seperti ("_") diloloskan dalam XML berseri. Itu DataSet sendiri hanya lolos dari karakter XML ilegal dalam nama elemen XML dan karenanya hanya dapat menggunakan yang sama. Ketika karakter hukum dalam nama elemen XML lolos, elemen diabaikan saat memproses.

Jika Skema XML untuk DataSet menyertakan targetNamespace, data mungkin tidak dibaca, dan Anda mungkin mengalami pengecualian saat memanggil ReadXml untuk memuat DataSet dengan XML yang berisi elemen tanpa namespace yang memenuhi syarat. Untuk membaca elemen yang tidak memenuhi syarat, atur elementFormDefault sama dengan "memenuhi syarat" dalam Skema XML Anda seperti yang ditunjukkan contoh berikut.

<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 mewarisi dari XmlReader.

Catatan

Jika skema untuk Anda DataSet berisi elemen dengan nama yang sama, tetapi jenis yang berbeda, di namespace yang sama, pengecualian dilemparkan saat Anda mencoba membaca skema ke dalam DataSet dengan dengan ReadXml menentukan XmlReadMode.ReadSchema. Pengecualian ini tidak terjadi jika Anda menggunakan .NET Framework versi 1.0.

Lihat juga

Berlaku untuk