DataSet.ReadXml Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает XML-схему и данные в DataSet.
Перегрузки
ReadXml(XmlReader, XmlReadMode) |
Считывает XML-схему и данные в DataSet, используя указанные объекты XmlReader и XmlReadMode. |
ReadXml(String, XmlReadMode) |
Считывает XML-схему и данные в DataSet, используя указанный файл и XmlReadMode. |
ReadXml(Stream, XmlReadMode) |
Считывает XML-схему и данные в DataSet, используя указанные объекты Stream и XmlReadMode. |
ReadXml(TextReader, XmlReadMode) |
Считывает XML-схему и данные в DataSet, используя указанные объекты TextReader и XmlReadMode. |
ReadXml(String) |
Считывает XML-схему и данные в DataSet, используя указанный файл. |
ReadXml(TextReader) |
Считывает XML-схему и данные в DataSet, используя указанный класс TextReader. |
ReadXml(Stream) |
Считывает XML-схему и данные в DataSet, используя указанный класс Stream. |
ReadXml(XmlReader) |
Считывает XML-схему и данные в DataSet, используя указанный класс XmlReader. |
ReadXml(XmlReader, XmlReadMode)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанные объекты XmlReader и 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
Параметры
- mode
- XmlReadMode
Одно из значений перечисления XmlReadMode.
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet содержит targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом, содержащим элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(String, XmlReadMode)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанный файл и 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
Параметры
- fileName
- String
Имя файла (включая путь), из которого производится чтение.
- mode
- XmlReadMode
Одно из значений перечисления XmlReadMode.
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Исключения
Для поля FileIOPermission не задан класс Read.
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet содержит targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом, содержащим элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(Stream, XmlReadMode)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанные объекты Stream и 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
Параметры
- mode
- XmlReadMode
Одно из значений перечисления XmlReadMode.
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
То же самое относится и к WriteXml методам и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Если используется ReadXml и задано значение Diffgram
XmlReadMode , содержимое целевого DataSet
и исходного DataSet
объектов может отличаться из-за того, как создается и обрабатывается диффграмма. Дополнительные сведения о диффграммах см. в разделе DiffGrams.
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet включает targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом могут возникнуть исключения, содержащие элементы без соответствующего пространства имен. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(TextReader, XmlReadMode)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанные объекты TextReader и XmlReadMode.
public:
System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode
Параметры
- reader
- TextReader
Класс TextReader, из которого выполняется чтение.
- mode
- XmlReadMode
Одно из значений перечисления XmlReadMode.
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet включает targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом могут возникнуть исключения, содержащие элементы без соответствующего пространства имен. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(String)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанный файл.
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
Имя файла (включая путь), из которого производится чтение.
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Исключения
Для поля FileIOPermission не задан класс Read.
Примеры
В следующем примере сначала создается простой DataSet объект с одним DataTable, двумя столбцами и десятью строками. Схема DataSet и данные записываются на диск путем вызова WriteXml метода . Создается вторая DataSet , и ReadXml метод используется для заполнения его схемой и данными.
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
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet содержит targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом, содержащим элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(TextReader)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
Считывает XML-схему и данные в DataSet, используя указанный класс 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
, из которого считывается схема и данные.
Возвращаемое значение
XmlReadMode служит для чтения данных.
Примеры
В следующем примере сначала создается простой DataSet объект с одним DataTable, двумя столбцами и десятью строками. Схема DataSet и данные записываются на диск путем вызова WriteXml метода . Создается вторая DataSet , и ReadXml метод используется для заполнения его схемой и данными.
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
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet включает targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом могут возникнуть исключения, содержащие элементы без соответствующего пространства имен. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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>
Классы, наследующие TextReader от класса , включают классы StreamReader и StringReader .
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
Применяется к
ReadXml(Stream)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- 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
Параметры
Возвращаемое значение
XmlReadMode служит для чтения данных.
Примеры
В следующем примере сначала создается простой DataSet объект с одним DataTable, двумя столбцами и десятью строками. Схема DataSet и данные записываются на диск путем вызова WriteXml метода . Создается вторая DataSet , и ReadXml метод используется для заполнения его схемой и данными.
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
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet включает targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом могут возникнуть исключения, содержащие элементы без соответствующего пространства имен. Чтобы считывать неквалифицированные элементы, задайте в elementFormDefault
схеме XML значение "qualified", как показано в следующем примере.
<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>
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.
См. также раздел
- ReadXmlSchema(XmlReader)
- WriteXml(Stream)
- WriteXmlSchema(Stream)
- Использование наборов данных в ADO.NET
Применяется к
ReadXml(XmlReader)
- Исходный код:
- DataSet.cs
- Исходный код:
- DataSet.cs
- Исходный код:
- 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
Параметры
Возвращаемое значение
XmlReadMode
служит для чтения данных.
Примеры
В следующем примере сначала создается простой DataSet объект с одним DataTable, двумя столбцами и десятью строками. Схема DataSet и данные записываются на диск путем вызова WriteXml метода . Создается вторая DataSet , и ReadXml метод используется для заполнения его схемой и данными.
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
Комментарии
Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataSet из XML-документа, тогда как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML
перегрузок, включающую mode
параметр , и присвойте ей значение ReadSchema
.
Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema соответственно. Для записи XML-данных или схемы и данных из DataSet
используйте WriteXml
метод . Чтобы написать только схему, используйте WriteXmlSchema
метод .
Примечание
Создается InvalidOperationException , если тип столбца в объекте , DataRow
считываемый из или записываемый IDynamicMetaObjectProvider в , реализует и не реализует IXmlSerializable.
Если указана встроенная схема, то встроенная схема используется для расширения существующей реляционной структуры перед загрузкой данных. При возникновении каких-либо конфликтов (например, одного и того же столбца в той же таблице, определенной с разными типами данных), возникает исключение.
Если встроенная схема не указана, реляционная структура при необходимости расширяется путем вывода в соответствии со структурой XML-документа. Если невозможно расширить схему с помощью вывода для предоставления всех данных, возникает исключение.
Примечание
не DataSet
связывает XML-элемент с соответствующим DataColumn
или DataTable
когда в сериализованном XML-коде экранируются легальные XML-символы, такие как ("_"). Сам DataSet
по себе экранирует только недопустимые XML-символы в именах XML-элементов и, следовательно, может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется при обработке.
Если xml-схема для DataSet содержит targetNamespace
, данные могут не читаться, и при вызове ReadXml для загрузки DataSet с XML-кодом, содержащим элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы считывать неквалифицированные элементы, задайте значение elementFormDefault
"qualified" в схеме XML, как показано в следующем примере.
<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 наследуется от интерфейса XmlReader.
Примечание
Если схема для содержит DataSet элементы с тем же именем, но другого типа, в том же пространстве имен при попытке считывания схемы в DataSet с ReadXml путем указания XmlReadMode.ReadSchema
. Это исключение не возникает, если используется платформа .NET Framework версии 1.0.