DataSet.ReadXml Метод

Определение

Считывает XML-схему и данные в DataSet.Reads XML schema and data into the DataSet.

Перегрузки

ReadXml(XmlReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты XmlReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXml(String, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанный файл и XmlReadMode.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты Stream и XmlReadMode.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты TextReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(String)

Считывает XML-схему и данные в DataSet, используя указанный файл.Reads XML schema and data into the DataSet using the specified file.

ReadXml(TextReader)

Считывает XML-схему и данные в DataSet, используя указанный класс TextReader.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(Stream)

Считывает XML-схему и данные в DataSet, используя указанный класс Stream.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(XmlReader)

Считывает XML-схему и данные в DataSet, используя указанный класс XmlReader.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты XmlReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified XmlReader and 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);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode

Параметры

reader
XmlReader

Класс XmlReader, из которого выполняется чтение.The XmlReader from which to read.

mode
XmlReadMode

Одно из значений перечисления XmlReadMode.One of the XmlReadMode values.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если DataSet XML-схема для targetNamespaceвключает, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

ReadXml(String, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанный файл и XmlReadMode.Reads XML schema and data into the DataSet using the specified file and 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

Имя файла (включая путь), из которого производится чтение.The filename (including the path) from which to read.

mode
XmlReadMode

Одно из значений перечисления XmlReadMode.One of the XmlReadMode values.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Исключения

Для поля FileIOPermission не задан класс Read.FileIOPermission is not set to Read.

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если DataSet XML-схема для targetNamespaceвключает, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Безопасность

FileIOPermission
для чтения и записи файлов.for reading and writing files. Связанное перечисление:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Дополнительно

ReadXml(Stream, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты Stream и XmlReadMode.Reads XML schema and data into the DataSet using the specified Stream and 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);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode

Параметры

stream
Stream

Класс Stream, из которого выполняется чтение.The Stream from which to read.

mode
XmlReadMode

Одно из значений перечисления XmlReadMode.One of the XmlReadMode values.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Это справедливо и для WriteXml методов и WriteXmlSchema соответственно.The same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

ReadXml Если используется DataSet и XmlReadMode DataSet задано значение ,содержимоецелевогообъектаиоригиналамогутотличатьсяиз-засозданияиобработкиDiffGram.DiffgramWhen you use ReadXml and you set XmlReadMode to Diffgram, the content of the target DataSet and the original DataSet may differ because of how the diffgram is generated and processed. Дополнительные сведения о дельтами см. в разделе дельтами.For more information on diffgrams, see DiffGrams.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если XML-схема DataSet для включает targetNamespace, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

ReadXml(TextReader, XmlReadMode)

Считывает XML-схему и данные в DataSet, используя указанные объекты TextReader и XmlReadMode.Reads XML schema and data into the DataSet using the specified TextReader and 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);
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, из которого выполняется чтение.The TextReader from which to read.

mode
XmlReadMode

Одно из значений перечисления XmlReadMode.One of the XmlReadMode values.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если XML-схема DataSet для включает targetNamespace, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

ReadXml(String)

Считывает XML-схему и данные в DataSet, используя указанный файл.Reads XML schema and data into the DataSet using the specified file.

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 filename (including the path) from which to read.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Исключения

Для поля FileIOPermission не задан класс Read.FileIOPermission is not set to Read.

Примеры

В следующем примере сначала создается простой DataSet с одним DataTable, двумя столбцами и десятью строками.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Схема и данные записываются на диск путем вызова WriteXml метода. DataSetThe DataSet schema and data are written to disk by invoking the WriteXml method. Создается вторая DataSet ReadXml и метод используется для его заполнения схемой и данными.A second DataSet is created and the ReadXml method is used to fill it with schema and 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

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если DataSet XML-схема для targetNamespaceвключает, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Безопасность

FileIOPermission
для чтения и записи файлов.for reading and writing files. Связанное перечисление:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Дополнительно

ReadXml(TextReader)

Считывает XML-схему и данные в DataSet, используя указанный класс TextReader.Reads XML schema and data into the DataSet using the specified TextReader.

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 from which to read the schema and data.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Примеры

В следующем примере сначала создается простой DataSet с одним DataTable, двумя столбцами и десятью строками.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Схема и данные записываются на диск путем вызова WriteXml метода. DataSetThe DataSet schema and data are written to disk by invoking the WriteXml method. Создается вторая DataSet ReadXml и метод используется для его заполнения схемой и данными.A second DataSet is created and the ReadXml method is used to fill it with schema and 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

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если XML-схема DataSet для включает targetNamespace, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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 классы и.Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

Примечание

Если схема для DataSet элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

ReadXml(Stream)

Считывает XML-схему и данные в DataSet, используя указанный класс Stream.Reads XML schema and data into the DataSet using the specified 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

Параметры

stream
Stream

Производный объект от класса Stream.An object that derives from Stream.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Примеры

В следующем примере сначала создается простой DataSet с одним DataTable, двумя столбцами и десятью строками.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Схема и данные записываются на диск путем вызова WriteXml метода. DataSetThe DataSet schema and data are written to disk by invoking the WriteXml method. Создается вторая DataSet ReadXml и метод используется для его заполнения схемой и данными.A second DataSet is created and the ReadXml method is used to fill it with schema and 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

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если XML-схема DataSet для включает targetNamespace, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema, as the following example demonstrates.

<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 элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

ReadXml(XmlReader)

Считывает XML-схему и данные в DataSet, используя указанный класс XmlReader.Reads XML schema and data into the DataSet using the specified XmlReader.

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 from which to read.

Возвраты

XmlReadMode служит для чтения данных.The XmlReadMode used to read the data.

Примеры

В следующем примере сначала создается простой DataSet с одним DataTable, двумя столбцами и десятью строками.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Схема и данные записываются на диск путем вызова WriteXml метода. DataSetThe DataSet schema and data are written to disk by invoking the WriteXml method. Создается вторая DataSet ReadXml и метод используется для его заполнения схемой и данными.A second DataSet is created and the ReadXml method is used to fill it with schema and 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

Комментарии

Метод предоставляет способ чтения только данных или данных и схемы DataSet в из XML-документа, в ReadXmlSchema то время как метод считывает только схему. ReadXmlThe ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Чтобы считать данные и схему, используйте одну из ReadXML перегрузок, mode включающих параметр, и задайте для ReadSchemaнего значение.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Обратите внимание, что это справедливо и WriteXml для WriteXmlSchema методов и соответственно.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Для записи XML-данных или схемы и данных из DataSet WriteXml используйте метод.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Чтобы записать только схему, используйте WriteXmlSchema метод.To write just the schema, use the WriteXmlSchema method.

Примечание

Исключение вызывается, если тип столбца в, DataRow который читается или записывается в, IDynamicMetaObjectProvider реализует и не реализует IXmlSerializable. InvalidOperationExceptionAn 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.

Примечание

Не связывает XML-элемент с соответствующим DataColumn или DataTable , если допустимые XML-символы, такие как (""), экранированы в сериализованном XML. DataSetThe 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.

Если DataSet XML-схема для targetNamespaceвключает, данные могут быть не считаны, и при вызове ReadXml для загрузки DataSet с XML, содержащим элементы без подходящих пространств имен, могут возникнуть исключения.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Чтобы считать неполные элементы, установите elementFormDefault значение, равное «квалифицировано», в схеме XML, как показано в следующем примере.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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.System.Xml.XmlTextReader inherits from XmlReader.

Примечание

Если схема для DataSet элементов Contains с тем же именем, но с другим типом, в одном пространстве имен, при попытке чтения схемы DataSet в с ReadXml XmlReadMode.ReadSchemaпомощью задается исключение.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Это исключение не происходит при использовании .NET Framework версии 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Дополнительно

Применяется к