DataTable.ReadXml Метод
Определение
Перегрузки
ReadXml(Stream) |
Считывает XML-схему и данные в DataTable, используя указанный класс Stream.Reads XML schema and data into the DataTable using the specified Stream. |
ReadXml(TextReader) |
Считывает XML-схему и данные в DataTable, используя указанный класс TextReader.Reads XML schema and data into the DataTable using the specified TextReader. |
ReadXml(String) |
Читает данные и схему XML в DataTable из указанного файла.Reads XML schema and data into the DataTable from the specified file. |
ReadXml(XmlReader) |
Читает данные и схему XML в DataTable, используя указанное средство чтения XmlReader.Reads XML Schema and Data into the DataTable using the specified XmlReader. |
Комментарии
ReadXmlМетод предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, в то время как ReadXmlSchema метод считывает только схему.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML
перегрузок, включающих XmlReadMode
параметр, и присвойте ему значение ReadSchema
.To read both data and schema, use one of the ReadXML
overloads that include the XmlReadMode
parameter, and set its value to ReadSchema
.
Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataTable
Используйте WriteXml
метод.To write XML data, or both schema and data from the DataTable
, use the WriteXml
method. Чтобы записать только схему, используйте WriteXmlSchema
метод.To write just the schema, use the WriteXmlSchema
method.
Примечание
InvalidOperationExceptionИсключение вызывается, если тип столбца в, который DataRow
читается или записывается в, реализует IDynamicMetaObjectProvider и не реализует IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow
being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.
ReadXml(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
Параметры
Возвращаемое значение
XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.
Примеры
В следующем примере создается объект, DataTable содержащий два столбца и десять строк.The following example creates a DataTable containing two columns and ten rows. В этом примере DataTable схема и данные записываются в поток памяти путем вызова WriteXml метода.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. В примере создается вторая DataTable и вызывается ReadXml метод для его заполнения схемой и данными.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.
private static void DemonstrateReadWriteXMLDocumentWithStream()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
DataTable newTable = new DataTable();
newTable.ReadXml(xmlStream);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
// Display the contents of the supplied DataTable:
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithStream()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim newTable As New DataTable
newTable.ReadXml(xmlStream)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, ByVal label As String)
' Display the contents of the supplied DataTable:
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Комментарии
Текущий DataTable и его потомков загружаются с данными из переданного Stream .The current DataTable and its descendents are loaded with the data from the supplied Stream. Поведение этого метода идентично поведению DataSet.ReadXml метода, за исключением того, что в данном случае данные загружаются только для текущей таблицы и ее потомков.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.
ReadXmlМетод предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, в то время как ReadXmlSchema метод считывает только схему.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.
Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataTable
Используйте WriteXml
метод.To write XML data, or both schema and data from the DataTable
, use the WriteXml
method. Чтобы записать только схему, используйте WriteXmlSchema
метод.To write just the schema, use the WriteXmlSchema
method.
Примечание
InvalidOperationExceptionИсключение вызывается, если тип столбца в, который DataRow
читается или записывается в, реализует IDynamicMetaObjectProvider и не реализует IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow
being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры до загрузки данных.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. При наличии конфликтов (например, одного столбца в той же таблице, определенной с разными типами данных) возникает исключение.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.
Если встроенная схема не указана, то при необходимости реляционная структура расширяется посредством вывода в соответствии со структурой XML-документа.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Если схема не может быть расширена посредством вывода, чтобы предоставить все данные, возникает исключение.If the schema cannot be extended through inference in order to expose all data, an exception is raised.
Примечание
Не DataSet
связывает XML-элемент с соответствующим DataColumn
или, DataTable
Если допустимые XML-символы, такие как (""), экранированы в сериализованном XML.The DataSet
does not associate an XML element with its corresponding DataColumn
or DataTable
when legal XML characters like ("") are escaped in the serialized XML. Сам по себе не содержит DataSet
недопустимые символы XML в именах XML-элементов и, следовательно, может использовать только одно и то же.The DataSet
itself only escapes illegal XML characters in XML element names and hence can only consume the same. Если допустимые символы в имени XML-элемента экранированы, во время обработки элемент пропускается.When legal characters in XML element name are escaped, the element is ignored while processing.
См. также раздел
Применяется к
ReadXml(TextReader)
Считывает XML-схему и данные в DataTable, используя указанный класс TextReader.Reads XML schema and data into the DataTable using the specified 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
Параметры
- reader
- TextReader
Объект TextReader, используемый для чтения данных.The TextReader that will be used to read the data.
Возвращаемое значение
XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.
Примеры
В следующем примере создается объект, DataTable содержащий два столбца и десять строк.The following example creates a DataTable containing two columns and ten rows. В этом примере DataTable схема и данные записываются в поток памяти путем вызова WriteXml метода.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. В примере создается вторая DataTable и вызывается ReadXml метод для его заполнения схемой и данными.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.
private static void DemonstrateReadWriteXMLDocumentWithReader()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
System.IO.StreamReader reader =
new System.IO.StreamReader(xmlStream);
DataTable newTable = new DataTable();
newTable.ReadXml(reader);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim reader As New System.IO.StreamReader(xmlStream)
Dim newTable As New DataTable
newTable.ReadXml(reader)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Комментарии
Текущий DataTable и его потомков загружаются с данными из переданного TextReader .The current DataTable and its descendents are loaded with the data from the supplied TextReader. Поведение этого метода идентично поведению DataSet.ReadXml метода, за исключением того, что в данном случае данные загружаются только для текущей таблицы и ее потомков.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.
ReadXmlМетод предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, в то время как ReadXmlSchema метод считывает только схему.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.
Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataTable
Используйте WriteXml
метод.To write XML data, or both schema and data from the DataTable
, use the WriteXml
method. Чтобы записать только схему, используйте WriteXmlSchema
метод.To write just the schema, use the WriteXmlSchema
method.
Примечание
InvalidOperationExceptionИсключение вызывается, если тип столбца в, который DataRow
читается или записывается в, реализует IDynamicMetaObjectProvider и не реализует IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow
being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры до загрузки данных.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. При наличии конфликтов (например, одного столбца в той же таблице, определенной с разными типами данных) возникает исключение.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.
Если встроенная схема не указана, то при необходимости реляционная структура расширяется посредством вывода в соответствии со структурой XML-документа.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Если схема не может быть расширена посредством вывода, чтобы предоставить все данные, возникает исключение.If the schema cannot be extended through inference in order to expose all data, an exception is raised.
Примечание
Не DataSet
связывает XML-элемент с соответствующим DataColumn
или, DataTable
Если допустимые XML-символы, такие как (""), экранированы в сериализованном XML.The DataSet
does not associate an XML element with its corresponding DataColumn
or DataTable
when legal XML characters like ("") are escaped in the serialized XML. Сам по себе не содержит DataSet
недопустимые символы XML в именах XML-элементов и, следовательно, может использовать только одно и то же.The DataSet
itself only escapes illegal XML characters in XML element names and hence can only consume the same. Если допустимые символы в имени XML-элемента экранированы, во время обработки элемент пропускается.When legal characters in XML element name are escaped, the element is ignored while processing.
См. также раздел
Применяется к
ReadXml(String)
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
Параметры
- fileName
- String
Имя файла, из которого читаются данные.The name of the file from which to read the data.
Возвращаемое значение
XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.
Примеры
В следующем примере создается объект, DataTable содержащий два столбца и десять строк.The following example creates a DataTable containing two columns and ten rows. В этом примере DataTable схема и данные записываются на диск.The example writes the DataTable schema and data to disk. В примере создается вторая DataTable и вызывается ReadXml метод для его заполнения схемой и данными.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.
private static void DemonstrateReadWriteXMLDocumentWithString()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
string fileName = "C:\\TestData.xml";
table.WriteXml(fileName, XmlWriteMode.WriteSchema);
DataTable newTable = new DataTable();
newTable.ReadXml(fileName);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithString()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a file.
Dim fileName As String = "C:\TestData.xml"
table.WriteXml(fileName, XmlWriteMode.WriteSchema)
Dim newTable As New DataTable
newTable.ReadXml(fileName)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Комментарии
Текущий DataTable и его дочерние файлы загружаются с данными из файла, указанного в указанном файле String .The current DataTable and its descendents are loaded with the data from the file named in the supplied String. Поведение этого метода идентично поведению DataSet.ReadXml метода, за исключением того, что в данном случае данные загружаются только для текущей таблицы и ее потомков.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.
ReadXmlМетод предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, в то время как ReadXmlSchema метод считывает только схему.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.
Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataTable
Используйте WriteXml
метод.To write XML data, or both schema and data from the DataTable
, use the WriteXml
method. Чтобы записать только схему, используйте WriteXmlSchema
метод.To write just the schema, use the WriteXmlSchema
method.
Примечание
InvalidOperationExceptionИсключение вызывается, если тип столбца в, который DataRow
читается или записывается в, реализует IDynamicMetaObjectProvider и не реализует IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow
being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры до загрузки данных.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. При наличии конфликтов (например, одного столбца в той же таблице, определенной с разными типами данных) возникает исключение.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.
Если встроенная схема не указана, то при необходимости реляционная структура расширяется посредством вывода в соответствии со структурой XML-документа.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Если схема не может быть расширена посредством вывода, чтобы предоставить все данные, возникает исключение.If the schema cannot be extended through inference in order to expose all data, an exception is raised.
Примечание
Не DataSet
связывает XML-элемент с соответствующим DataColumn
или, DataTable
Если допустимые XML-символы, такие как (""), экранированы в сериализованном XML.The DataSet
does not associate an XML element with its corresponding DataColumn
or DataTable
when legal XML characters like ("") are escaped in the serialized XML. Сам по себе не содержит DataSet
недопустимые символы XML в именах XML-элементов и, следовательно, может использовать только одно и то же.The DataSet
itself only escapes illegal XML characters in XML element names and hence can only consume the same. Если допустимые символы в имени XML-элемента экранированы, во время обработки элемент пропускается.When legal characters in XML element name are escaped, the element is ignored while processing.
using System.Data;
public class A {
static void Main(string[] args) {
DataTable tabl = new DataTable("mytable");
tabl.Columns.Add(new DataColumn("id", typeof(int)));
for (int i = 0; i < 10; i++) {
DataRow row = tabl.NewRow();
row["id"] = i;
tabl.Rows.Add(row);
}
tabl.WriteXml("f.xml", XmlWriteMode.WriteSchema);
DataTable newt = new DataTable();
newt.ReadXml("f.xml");
}
}
См. также раздел
Применяется к
ReadXml(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
Параметры
- reader
- XmlReader
Объект XmlReader, используемый для чтения данных.The XmlReader that will be used to read the data.
Возвращаемое значение
XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.
Примеры
В следующем примере создается объект, DataTable содержащий два столбца и десять строк.The following example creates a DataTable containing two columns and ten rows. В этом примере DataTable схема и данные записываются в XmlReader .The example writes the DataTable schema and data to an XmlReader. В примере создается вторая DataTable и вызывается ReadXml метод для его заполнения схемой и данными из XmlReader экземпляра.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data from the XmlReader instance.
private static void DemonstrateReadWriteXMLDocumentWithReader()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
System.Xml.XmlTextReader reader =
new System.Xml.XmlTextReader(xmlStream);
DataTable newTable = new DataTable();
newTable.ReadXml(reader);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim reader As New System.Xml.XmlTextReader(xmlStream)
Dim newTable As New DataTable
newTable.ReadXml(reader)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Комментарии
Текущий DataTable и его дочерние файлы загружаются с данными из файла, указанного в указанном файле XmlReader .The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. Поведение этого метода идентично поведению ReadXml метода, за исключением того, что в данном случае данные загружаются только для текущей таблицы и ее потомков.The behavior of this method is identical to that of the ReadXml method, except that in this case, data is loaded only for the current table and its descendants.
ReadXmlМетод предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, в то время как ReadXmlSchema метод считывает только схему.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.
Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataTable
Используйте WriteXml
метод.To write XML data, or both schema and data from the DataTable
, use the WriteXml
method. Чтобы записать только схему, используйте WriteXmlSchema
метод.To write just the schema, use the WriteXmlSchema
method.
Примечание
InvalidOperationExceptionИсключение вызывается, если тип столбца в, который DataRow
читается или записывается в, реализует IDynamicMetaObjectProvider и не реализует IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow
being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры до загрузки данных.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. При наличии конфликтов (например, одного столбца в той же таблице, определенной с разными типами данных) возникает исключение.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.
Если встроенная схема не указана, то при необходимости реляционная структура расширяется посредством вывода в соответствии со структурой XML-документа.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Если схема не может быть расширена посредством вывода, чтобы предоставить все данные, возникает исключение.If the schema cannot be extended through inference in order to expose all data, an exception is raised.
Примечание
Не DataSet
связывает XML-элемент с соответствующим DataColumn
или, DataTable
Если допустимые XML-символы, такие как (""), экранированы в сериализованном XML.The DataSet
does not associate an XML element with its corresponding DataColumn
or DataTable
when legal XML characters like ("") are escaped in the serialized XML. Сам по себе не содержит DataSet
недопустимые символы XML в именах XML-элементов и, следовательно, может использовать только одно и то же.The DataSet
itself only escapes illegal XML characters in XML element names and hence can only consume the same. Если допустимые символы в имени XML-элемента экранированы, во время обработки элемент пропускается.When legal characters in XML element name are escaped, the element is ignored while processing.