DataSet.ReadXml Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- 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
FileIOPermission tidak diatur ke Read.
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
- 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
FileIOPermission tidak diatur ke Read.
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
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
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
- ReadXmlSchema(XmlReader)
- WriteXml(Stream)
- WriteXmlSchema(Stream)
- Menggunakan Himpunan Data di ADO.NET
Berlaku untuk
ReadXml(XmlReader)
- Sumber:
- DataSet.cs
- Sumber:
- DataSet.cs
- Sumber:
- DataSet.cs
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
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.