DataTable.ReadXml Metoda

Definicja

Odczytuje schemat XML i dane do DataTable .Reads XML schema and data into the DataTable.

Przeciążenia

ReadXml(Stream)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu Stream .Reads XML schema and data into the DataTable using the specified Stream.

ReadXml(TextReader)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu TextReader .Reads XML schema and data into the DataTable using the specified TextReader.

ReadXml(String)

Odczytuje schemat XML i dane do DataTable z określonego pliku.Reads XML schema and data into the DataTable from the specified file.

ReadXml(XmlReader)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu XmlReader .Reads XML Schema and Data into the DataTable using the specified XmlReader.

Uwagi

ReadXmlMetoda pozwala odczytać tylko dane lub dane i schemat do DataTable z dokumentu XML, natomiast ReadXmlSchema Metoda odczytuje tylko schemat.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema. Aby odczytać zarówno dane, jak i schemat, użyj jednego z ReadXML przeciążeń, które zawierają XmlReadMode parametr, i ustaw jego wartość na ReadSchema .To read both data and schema, use one of the ReadXML overloads that include the XmlReadMode parameter, and set its value to ReadSchema.

Należy zauważyć, że ta sama wartość dotyczy WriteXml WriteXmlSchema metod i.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Aby zapisać dane XML lub schemat i dane z DataTable , użyj WriteXml metody.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Aby zapisać tylko schemat, użyj WriteXmlSchema metody.To write just the schema, use the WriteXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

ReadXml(Stream)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu Stream .Reads XML schema and data into the DataTable using the specified Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream) As XmlReadMode

Parametry

stream
Stream

Obiekt, który pochodzi z StreamAn object that derives from Stream

Zwraca

XmlReadMode

XmlReadModeUżywane do odczytywania danych.The XmlReadMode used to read the data.

Przykłady

Poniższy przykład tworzy DataTable dwie kolumny i dziesięć wierszy.The following example creates a DataTable containing two columns and ten rows. Przykład zapisuje DataTable schemat i dane do strumienia pamięci, wywołując WriteXml metodę.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. Przykład tworzy sekundę DataTable i wywołuje ReadXml metodę, aby wypełnić ją schematem i danymi.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

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

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

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

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

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

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

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

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

    table.AcceptChanges();
    return table;
}

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

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

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim newTable As New DataTable
  newTable.ReadXml(xmlStream)

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

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

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

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

  table.AcceptChanges()
  Return table
End Function

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

Uwagi

Bieżąca DataTable i jej elementy potomne są ładowane z danymi z dostarczonego Stream .The current DataTable and its descendents are loaded with the data from the supplied Stream. Zachowanie tej metody jest takie samo jak DataSet.ReadXml w przypadku metody, z tą różnicą, że dane są ładowane tylko dla bieżącej tabeli i jej obiektów podrzędnych.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

ReadXmlMetoda pozwala odczytać tylko dane lub dane i schemat do DataTable z dokumentu XML, natomiast ReadXmlSchema Metoda odczytuje tylko schemat.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Należy zauważyć, że ta sama wartość dotyczy WriteXml WriteXmlSchema metod i.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Aby zapisać dane XML lub schemat i dane z DataTable , użyj WriteXml metody.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Aby zapisać tylko schemat, użyj WriteXmlSchema metody.To write just the schema, use the WriteXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Jeśli jest określony schemat w wierszu, schemat wbudowany jest używany do rozbudowy istniejącej struktury relacyjnej przed załadowaniem danych.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Jeśli wystąpią konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej przy użyciu różnych typów danych), zgłaszany jest wyjątek.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Jeśli nie zostanie określony żaden schemat w wierszu, struktura relacyjna zostanie przedłużona w miarę potrzeb, zgodnie ze strukturą dokumentu 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. Jeśli schematu nie można rozszerzyć za pomocą wnioskowania w celu udostępnienia wszystkich danych, zostanie zgłoszony wyjątek.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Uwaga

Nie DataSet kojarzy elementu XML z odpowiadającym mu DataColumn lub, DataTable gdy prawne znaki XML, takie jak (""), są wyprowadzane w serializowanym kodzie XML.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. DataSetSama sama wyprowadza tylko niedozwolone znaki XML w nazwach elementów XML i w związku z tym może korzystać tylko z tego samego.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Gdy znaki prawne w nazwie elementu XML są wyprowadzane, element jest ignorowany podczas przetwarzania.When legal characters in XML element name are escaped, the element is ignored while processing.

Dotyczy

ReadXml(TextReader)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu TextReader .Reads XML schema and data into the DataTable using the specified TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

Parametry

reader
TextReader

TextReader, Który będzie używany do odczytywania danych.The TextReader that will be used to read the data.

Zwraca

XmlReadMode

XmlReadModeUżywane do odczytywania danych.The XmlReadMode used to read the data.

Przykłady

Poniższy przykład tworzy DataTable dwie kolumny i dziesięć wierszy.The following example creates a DataTable containing two columns and ten rows. Przykład zapisuje DataTable schemat i dane do strumienia pamięci, wywołując WriteXml metodę.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. Przykład tworzy sekundę DataTable i wywołuje ReadXml metodę, aby wypełnić ją schematem i danymi.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

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

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

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

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

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

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

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

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

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

  ' Rewind the memory stream.
  xmlStream.Position = 0

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

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

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

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

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

  table.AcceptChanges()
  Return table
End Function

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

Uwagi

Bieżąca DataTable i jej elementy potomne są ładowane z danymi z dostarczonego TextReader .The current DataTable and its descendents are loaded with the data from the supplied TextReader. Zachowanie tej metody jest takie samo jak DataSet.ReadXml w przypadku metody, z tą różnicą, że dane są ładowane tylko dla bieżącej tabeli i jej obiektów podrzędnych.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

ReadXmlMetoda pozwala odczytać tylko dane lub dane i schemat do DataTable z dokumentu XML, natomiast ReadXmlSchema Metoda odczytuje tylko schemat.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Należy zauważyć, że ta sama wartość dotyczy WriteXml WriteXmlSchema metod i.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Aby zapisać dane XML lub schemat i dane z DataTable , użyj WriteXml metody.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Aby zapisać tylko schemat, użyj WriteXmlSchema metody.To write just the schema, use the WriteXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Jeśli jest określony schemat w wierszu, schemat wbudowany jest używany do rozbudowy istniejącej struktury relacyjnej przed załadowaniem danych.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Jeśli wystąpią konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej przy użyciu różnych typów danych), zgłaszany jest wyjątek.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Jeśli nie zostanie określony żaden schemat w wierszu, struktura relacyjna zostanie przedłużona w miarę potrzeb, zgodnie ze strukturą dokumentu 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. Jeśli schematu nie można rozszerzyć za pomocą wnioskowania w celu udostępnienia wszystkich danych, zostanie zgłoszony wyjątek.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Uwaga

Nie DataSet kojarzy elementu XML z odpowiadającym mu DataColumn lub, DataTable gdy prawne znaki XML, takie jak (""), są wyprowadzane w serializowanym kodzie XML.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. DataSetSama sama wyprowadza tylko niedozwolone znaki XML w nazwach elementów XML i w związku z tym może korzystać tylko z tego samego.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Gdy znaki prawne w nazwie elementu XML są wyprowadzane, element jest ignorowany podczas przetwarzania.When legal characters in XML element name are escaped, the element is ignored while processing.

Dotyczy

ReadXml(String)

Odczytuje schemat XML i dane do DataTable z określonego pliku.Reads XML schema and data into the DataTable from 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

Parametry

fileName
String

Nazwa pliku, z którego mają zostać odczytane dane.The name of the file from which to read the data.

Zwraca

XmlReadMode

XmlReadModeUżywane do odczytywania danych.The XmlReadMode used to read the data.

Przykłady

Poniższy przykład tworzy DataTable dwie kolumny i dziesięć wierszy.The following example creates a DataTable containing two columns and ten rows. Przykład zapisuje DataTable schemat i dane na dysku.The example writes the DataTable schema and data to disk. Przykład tworzy sekundę DataTable i wywołuje ReadXml metodę, aby wypełnić ją schematem i danymi.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

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

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

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

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

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

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

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithString()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

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

  Dim newTable As New DataTable
  newTable.ReadXml(fileName)

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

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

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

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

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

  table.AcceptChanges()
  Return table
End Function

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

Uwagi

Bieżąca DataTable i jej elementy podrzędne są ładowane z danymi z pliku o nazwie w podanym elemencie String .The current DataTable and its descendents are loaded with the data from the file named in the supplied String. Zachowanie tej metody jest takie samo jak DataSet.ReadXml w przypadku metody, z tą różnicą, że dane są ładowane tylko dla bieżącej tabeli i jej obiektów podrzędnych.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

ReadXmlMetoda pozwala odczytać tylko dane lub dane i schemat do DataTable z dokumentu XML, natomiast ReadXmlSchema Metoda odczytuje tylko schemat.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Należy zauważyć, że ta sama wartość dotyczy WriteXml WriteXmlSchema metod i.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Aby zapisać dane XML lub schemat i dane z DataTable , użyj WriteXml metody.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Aby zapisać tylko schemat, użyj WriteXmlSchema metody.To write just the schema, use the WriteXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Jeśli jest określony schemat w wierszu, schemat wbudowany jest używany do rozbudowy istniejącej struktury relacyjnej przed załadowaniem danych.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Jeśli wystąpią konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej przy użyciu różnych typów danych), zgłaszany jest wyjątek.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Jeśli nie zostanie określony żaden schemat w wierszu, struktura relacyjna zostanie przedłużona w miarę potrzeb, zgodnie ze strukturą dokumentu 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. Jeśli schematu nie można rozszerzyć za pomocą wnioskowania w celu udostępnienia wszystkich danych, zostanie zgłoszony wyjątek.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Uwaga

Nie DataSet kojarzy elementu XML z odpowiadającym mu DataColumn lub, DataTable gdy prawne znaki XML, takie jak (""), są wyprowadzane w serializowanym kodzie XML.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. DataSetSama sama wyprowadza tylko niedozwolone znaki XML w nazwach elementów XML i w związku z tym może korzystać tylko z tego samego.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Gdy znaki prawne w nazwie elementu XML są wyprowadzane, element jest ignorowany podczas przetwarzania.When legal characters in XML element name are escaped, the element is ignored while processing.

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

Dotyczy

ReadXml(XmlReader)

Odczytuje schemat XML i dane do DataTable przy użyciu określonego elementu XmlReader .Reads XML Schema and Data into the DataTable using the specified XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parametry

reader
XmlReader

XmlReader, Który będzie używany do odczytywania danych.The XmlReader that will be used to read the data.

Zwraca

XmlReadMode

XmlReadModeUżywane do odczytywania danych.The XmlReadMode used to read the data.

Przykłady

Poniższy przykład tworzy DataTable dwie kolumny i dziesięć wierszy.The following example creates a DataTable containing two columns and ten rows. Przykład zapisuje DataTable schemat i dane w XmlReader .The example writes the DataTable schema and data to an XmlReader. Przykład tworzy sekundę DataTable i wywołuje ReadXml metodę, aby wypełnić ją schematem i danymi z XmlReader wystąpienia.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data from the XmlReader instance.

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

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

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

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

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

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

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

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

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

  ' Rewind the memory stream.
  xmlStream.Position = 0

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

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

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

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

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

  table.AcceptChanges()
  Return table
End Function

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

Uwagi

Bieżąca DataTable i jej elementy podrzędne są ładowane z danymi z pliku o nazwie w podanym elemencie XmlReader .The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. Zachowanie tej metody jest takie samo jak ReadXml w przypadku metody, z tą różnicą, że dane są ładowane tylko dla bieżącej tabeli i jej obiektów podrzędnych.The behavior of this method is identical to that of the ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

ReadXmlMetoda pozwala odczytać tylko dane lub dane i schemat do DataTable z dokumentu XML, natomiast ReadXmlSchema Metoda odczytuje tylko schemat.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Należy zauważyć, że ta sama wartość dotyczy WriteXml WriteXmlSchema metod i.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Aby zapisać dane XML lub schemat i dane z DataTable , użyj WriteXml metody.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Aby zapisać tylko schemat, użyj WriteXmlSchema metody.To write just the schema, use the WriteXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Jeśli jest określony schemat w wierszu, schemat wbudowany jest używany do rozbudowy istniejącej struktury relacyjnej przed załadowaniem danych.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Jeśli wystąpią konflikty (na przykład ta sama kolumna w tej samej tabeli zdefiniowanej przy użyciu różnych typów danych), zgłaszany jest wyjątek.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Jeśli nie zostanie określony żaden schemat w wierszu, struktura relacyjna zostanie przedłużona w miarę potrzeb, zgodnie ze strukturą dokumentu 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. Jeśli schematu nie można rozszerzyć za pomocą wnioskowania w celu udostępnienia wszystkich danych, zostanie zgłoszony wyjątek.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Uwaga

Nie DataSet kojarzy elementu XML z odpowiadającym mu DataColumn lub, DataTable gdy prawne znaki XML, takie jak (""), są wyprowadzane w serializowanym kodzie XML.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. DataSetSama sama wyprowadza tylko niedozwolone znaki XML w nazwach elementów XML i w związku z tym może korzystać tylko z tego samego.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Gdy znaki prawne w nazwie elementu XML są wyprowadzane, element jest ignorowany podczas przetwarzania.When legal characters in XML element name are escaped, the element is ignored while processing.

Dotyczy