DataSet.ReadXml Метод

Определение

Считывает XML-схему и данные в DataSetобъект .

Перегрузки

Имя Описание
ReadXml(XmlReader, XmlReadMode)

Считывает XML-схему и данные в указанный DataSetXmlReader и XmlReadMode.

ReadXml(String, XmlReadMode)

Считывает XML-схему и данные в DataSet указанный файл и XmlReadModeданные.

ReadXml(Stream, XmlReadMode)

Считывает XML-схему и данные в указанный DataSetStream и XmlReadMode.

ReadXml(TextReader, XmlReadMode)

Считывает XML-схему и данные в указанный DataSetTextReader и 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
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные в указанный DataSetXmlReader и XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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 которого следует читать.

mode
XmlReadMode

Одно из значений XmlReadMode .

Возвращаемое значение

Используется XmlReadMode для чтения данных.

Атрибуты

Комментарии

Этот ReadXml метод предоставляет способ чтения только данных или как данных, так и схемы DataSet в XML-документе, в то время как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML перегрузок, включающих параметр, и задайте для нее mode значение ReadSchema.

Обратите внимание, что то же самое верно для WriteXml методов и WriteXmlSchema методов соответственно. Для записи XML-данных или схемы и данных из DataSetэтого WriteXml метода используйте этот метод. Чтобы написать только схему WriteXmlSchema , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если xml-схема для включена DataSettargetNamespace, данные могут быть не прочитаны, и при вызове вызова ReadXml для загрузки DataSet xml, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(String, XmlReadMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные в DataSet указанный файл и XmlReadModeданные.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml(string fileName, System.Data.XmlReadMode mode);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName, System.Data.XmlReadMode mode);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если xml-схема для включена DataSettargetNamespace, данные могут быть не прочитаны, и при вызове вызова ReadXml для загрузки DataSet xml, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(Stream, XmlReadMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные в указанный DataSetStream и XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode

Параметры

stream
Stream

Из Stream которого следует читать.

mode
XmlReadMode

Одно из значений XmlReadMode .

Возвращаемое значение

Используется XmlReadMode для чтения данных.

Атрибуты

Комментарии

Этот ReadXml метод предоставляет способ чтения только данных или как данных, так и схемы DataSet в XML-документе, в то время как ReadXmlSchema метод считывает только схему. Чтобы считывать данные и схему, используйте одну из ReadXML перегрузок, включающих параметр, и задайте для нее mode значение ReadSchema.

То же самое верно для WriteXml методов и WriteXmlSchema методов соответственно. Для записи XML-данных или схемы и данных из DataSetэтого WriteXml метода используйте этот метод. Чтобы написать только схему WriteXmlSchema , используйте метод.

Note

При использовании ReadXml и настройке XmlReadModeDiffgram содержимого целевого объекта DataSet и исходного DataSet может отличаться из-за того, как создается и обрабатывается диффграмма. Дополнительные сведения о диффграммах см. в разделе DiffGrams.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если схема XML для включена DataSettargetNamespace, данные могут не считываться, и при вызове для ReadXml загрузки DataSet xml-кода, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(TextReader, XmlReadMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные в указанный DataSetTextReader и XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
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);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если схема XML для включена DataSettargetNamespace, данные могут не считываться, и при вызове для ReadXml загрузки DataSet xml-кода, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(String)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные в DataSet указанный файл.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName);
public System.Data.XmlReadMode ReadXml(string fileName);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : string -> System.Data.XmlReadMode
member this.ReadXml : string -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если xml-схема для включена DataSettargetNamespace, данные могут быть не прочитаны, и при вызове вызова ReadXml для загрузки DataSet xml, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(TextReader)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные DataSet в указанный параметр TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader);
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader);
public System.Data.XmlReadMode ReadXml(System.IO.TextReader reader);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если схема XML для включена DataSettargetNamespace, данные могут не считываться, и при вызове для ReadXml загрузки DataSet xml-кода, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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 классы.

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(Stream)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные DataSet в указанный параметр Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml(System.IO.Stream stream);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream) As XmlReadMode

Параметры

stream
Stream

Объект, производный от Stream.

Возвращаемое значение

Используется 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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если схема XML для включена DataSettargetNamespace, данные могут не считываться, и при вызове для ReadXml загрузки DataSet xml-кода, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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>

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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

ReadXml(XmlReader)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Считывает XML-схему и данные DataSet в указанный параметр XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader reader);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Параметры

reader
XmlReader

Из XmlReader которого следует читать.

Возвращаемое значение

Используется 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 , используйте метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

Если указана встроенная схема, то для расширения существующей реляционной структуры перед загрузкой данных используется встроенная схема. Если возникают конфликты (например, один и тот же столбец в одной таблице, определенной с разными типами данных), возникает исключение.

Если схема в строке не указана, реляционная структура расширяется путем вывода по мере необходимости в соответствии со структурой XML-документа. Если схема не может быть расширена с помощью вывода для предоставления всех данных, возникает исключение.

Note

Элемент DataSet XML не связывается с соответствующим DataColumn или DataTable когда юридические XML-символы, такие как ("_"), экранируются в сериализованном XML. Сам DataSet по себе экранирует только недопустимые XML-символы в именах ЭЛЕМЕНТОВ XML, поэтому может использовать только те же. При экранировании юридических символов в имени XML-элемента элемент игнорируется во время обработки.

Если xml-схема для включена DataSettargetNamespace, данные могут быть не прочитаны, и при вызове вызова ReadXml для загрузки DataSet xml, содержащего элементы без соответствующего пространства имен, могут возникнуть исключения. Чтобы прочитать неквалифицированные элементы, задайте elementFormDefault значение "квалифицировано" в схеме 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.

Note

Если схема содержит DataSet элементы одного и того же имени, но другой тип в одном пространстве имен, исключение возникает при попытке считывания схемы в DataSet с ReadXml помощью указания XmlReadMode.ReadSchema. Это исключение не происходит, если используется .NET Framework версии 1.0.

См. также раздел

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