DataTable.ReadXml Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Считывает XML-схему и данные в DataTable.

Перегрузки

ReadXml(Stream)	Считывает XML-схему и данные в DataTable, используя указанный класс Stream.
ReadXml(TextReader)	Считывает XML-схему и данные в DataTable, используя указанный класс TextReader.
ReadXml(String)	Читает данные и схему XML в DataTable из указанного файла.
ReadXml(XmlReader)	Читает данные и схему XML в DataTable, используя указанное средство чтения XmlReader.

Комментарии

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

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

Примечание

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

ReadXml(Stream)

Исходный код:

DataTable.cs

Считывает XML-схему и данные в DataTable, используя указанный класс Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);

public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);

member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Public Function ReadXml (stream As Stream) As XmlReadMode

Параметры

stream

Stream

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

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

XmlReadMode

XmlReadMode служит для чтения данных.

Примеры

В следующем примере создается объект , DataTable содержащий два столбца и десять строк. В примере схема и данные записываются DataTable в поток памяти путем вызова WriteXml метода . В примере создается вторая DataTable и вызывается метод для ReadXml заполнения его схемой и данными.

private static void DemonstrateReadWriteXMLDocumentWithStream()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    newTable.ReadXml(xmlStream);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    // Display the contents of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithStream()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim newTable As New DataTable
  newTable.ReadXml(xmlStream)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, ByVal label As String)
  ' Display the contents of the supplied DataTable:
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Комментарии

Текущий DataTable и его потомки загружаются с данными из предоставленного Stream. Поведение этого метода идентично DataSet.ReadXml поведению метода , за исключением того, что в этом случае данные загружаются только для текущей таблицы и ее потомков.

Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, тогда как ReadXmlSchema метод считывает только схему.

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

Примечание

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

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

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

Примечание

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

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

• DataTables

ReadXml(TextReader)

Исходный код:

DataTable.cs

Считывает XML-схему и данные в DataTable, используя указанный класс 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, используемый для чтения данных.

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

XmlReadMode

XmlReadMode служит для чтения данных.

Примеры

В следующем примере создается объект , DataTable содержащий два столбца и десять строк. В примере схема и данные записываются DataTable в поток памяти путем вызова WriteXml метода . В примере создается вторая DataTable и вызывается метод для ReadXml заполнения его схемой и данными.

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.IO.StreamReader reader =
        new System.IO.StreamReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.IO.StreamReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Комментарии

Текущий DataTable и его потомки загружаются с данными из предоставленного TextReader. Поведение этого метода идентично DataSet.ReadXml поведению метода , за исключением того, что в этом случае данные загружаются только для текущей таблицы и ее потомков.

Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, тогда как ReadXmlSchema метод считывает только схему.

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

Примечание

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

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

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

Примечание

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

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

• DataTables

ReadXml(String)

Исходный код:

DataTable.cs

Читает данные и схему XML в DataTable из указанного файла.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);

public System.Data.XmlReadMode ReadXml (string fileName);

member this.ReadXml : string -> System.Data.XmlReadMode

Public Function ReadXml (fileName As String) As XmlReadMode

Параметры

fileName

String

Имя файла, из которого читаются данные.

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

XmlReadMode

XmlReadMode служит для чтения данных.

Примеры

В следующем примере создается объект , DataTable содержащий два столбца и десять строк. В примере схема и данные записываются DataTable на диск. В примере создается вторая DataTable и вызывается метод для ReadXml заполнения его схемой и данными.

private static void DemonstrateReadWriteXMLDocumentWithString()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    string fileName = "C:\\TestData.xml";
    table.WriteXml(fileName, XmlWriteMode.WriteSchema);

    DataTable newTable = new DataTable();
    newTable.ReadXml(fileName);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithString()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a file.
  Dim fileName As String = "C:\TestData.xml"
  table.WriteXml(fileName, XmlWriteMode.WriteSchema)

  Dim newTable As New DataTable
  newTable.ReadXml(fileName)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable

  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Комментарии

Текущий DataTable и его потомки загружаются с данными из файла с именем в предоставленном String. Поведение этого метода идентично DataSet.ReadXml поведению метода , за исключением того, что в этом случае данные загружаются только для текущей таблицы и ее потомков.

Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, тогда как ReadXmlSchema метод считывает только схему.

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

Примечание

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

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

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

Примечание

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

using System.Data;
public class A {
   static void Main(string[] args) {
      DataTable tabl = new DataTable("mytable");
      tabl.Columns.Add(new DataColumn("id", typeof(int)));
      for (int i = 0; i < 10; i++) {
         DataRow row = tabl.NewRow();
         row["id"] = i;
         tabl.Rows.Add(row);
      }
      tabl.WriteXml("f.xml", XmlWriteMode.WriteSchema);
      DataTable newt = new DataTable();
      newt.ReadXml("f.xml");
   }
}

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

• DataTables

ReadXml(XmlReader)

Исходный код:

DataTable.cs

Читает данные и схему XML в DataTable, используя указанное средство чтения 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, используемый для чтения данных.

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

XmlReadMode

XmlReadMode служит для чтения данных.

Примеры

В следующем примере создается объект , DataTable содержащий два столбца и десять строк. В примере схема и данные записываются DataTable в .XmlReader В примере создается секунда DataTable и вызывается ReadXml метод для заполнения его схемой и данными из экземпляра XmlReader .

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.Xml.XmlTextReader reader =
        new System.Xml.XmlTextReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.Xml.XmlTextReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Комментарии

Текущий DataTable и его потомки загружаются с данными из файла с именем в предоставленном XmlReader. Поведение этого метода идентично ReadXml поведению метода , за исключением того, что в этом случае данные загружаются только для текущей таблицы и ее потомков.

Метод ReadXml предоставляет способ чтения только данных или данных и схемы в DataTable из XML-документа, тогда как ReadXmlSchema метод считывает только схему.

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

Примечание

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

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

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

Примечание

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

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

• DataTables