DataTable.ReadXml メソッド

定義

XML スキーマとデータを DataTable に読み込みます。Reads XML schema and data into the DataTable.

オーバーロード

ReadXml(Stream)

指定した DataTable を使用して、XML スキーマとデータを Stream に読み込みます。Reads XML schema and data into the DataTable using the specified Stream.

ReadXml(TextReader)

指定した DataTable を使用して、XML スキーマとデータを TextReader に読み込みます。Reads XML schema and data into the DataTable using the specified TextReader.

ReadXml(String)

指定したファイルから、XML スキーマとデータを DataTable に読み込みます。Reads XML schema and data into the DataTable from the specified file.

ReadXml(XmlReader)

指定した DataTable を使用して、XML スキーマとデータを XmlReader に読み込みます。Reads XML Schema and Data into the DataTable using the specified XmlReader.

注釈

メソッドは、データのみ、またはデータとスキーマDataTableの両方をReadXmlSchema XML ドキュメントからに読み取る方法を提供します。一方、メソッドはスキーマのみを読み取ります。 ReadXmlThe 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. データとスキーマの両方を読み取るには、 ReadXML XmlReadModeパラメーターを含むオーバーロードのいずれかを使用し、そのReadSchema値をに設定します。To read both data and schema, use one of the ReadXML overloads that include the XmlReadMode parameter, and set its value to ReadSchema.

メソッドWriteXmlWriteXmlSchemaメソッドについても同じことに注意してください。Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. XML データ、またはのDataTableスキーマとデータの両方を書き込むには、 WriteXmlメソッドを使用します。To write XML data, or both schema and data from the DataTable, use the WriteXml method. スキーマだけを書き込むには、 WriteXmlSchemaメソッドを使用します。To write just the schema, use the WriteXmlSchema method.

注意

InvalidOperationException読み込みまたは書き込みを行うDataRow IDynamicMetaObjectProvider内の列の型がを実装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)

指定した DataTable を使用して、XML スキーマとデータを 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);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

パラメーター

stream
Stream

Stream から派生するオブジェクト。An object that derives from Stream

戻り値

データを読み込むために使用する XmlReadModeThe XmlReadMode used to read the data.

次の例ではDataTable 、2つの列と10個の行を含むを作成します。The following example creates a DataTable containing two columns and ten rows. この例ではDataTableWriteXmlメソッドを呼び出すことによって、スキーマとデータをメモリストリームに書き込みます。The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. 次の例ではDataTable 、2番ReadXml目のを作成し、メソッドを呼び出してスキーマとデータを格納します。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

注釈

現在DataTableのとその子孫は、指定Streamされたのデータと共に読み込まれます。The current DataTable and its descendents are loaded with the data from the supplied Stream. このメソッドの動作は、 DataSet.ReadXmlメソッドの動作と同じですが、この場合は、現在のテーブルとその子孫に対してのみデータが読み込まれる点が異なります。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.

メソッドは、データのみ、またはデータとスキーマDataTableの両方をReadXmlSchema XML ドキュメントからに読み取る方法を提供します。一方、メソッドはスキーマのみを読み取ります。 ReadXmlThe 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.

メソッドWriteXmlWriteXmlSchemaメソッドについても同じことに注意してください。Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. XML データ、またはのDataTableスキーマとデータの両方を書き込むには、 WriteXmlメソッドを使用します。To write XML data, or both schema and data from the DataTable, use the WriteXml method. スキーマだけを書き込むには、 WriteXmlSchemaメソッドを使用します。To write just the schema, use the WriteXmlSchema method.

注意

InvalidOperationException読み込みまたは書き込みを行うDataRow IDynamicMetaObjectProvider内の列の型がを実装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.

インラインスキーマが指定されている場合は、データを読み込む前に、インラインスキーマを使用して既存のリレーショナル構造が拡張されます。If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. 競合がある場合 (たとえば、同じテーブル内の同じ列が異なるデータ型で定義されている場合)、例外が発生します。If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

インラインスキーマが指定されていない場合、XML ドキュメントの構造に従って、必要に応じて、推論によってリレーショナル構造が拡張されます。If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。If the schema cannot be extended through inference in order to expose all data, an exception is raised.

注意

DataSet 、xml 要素とそれに対応するDataColumnに関連DataTable付けられていないか、または ("") のような有効な xml 文字がシリアル化された xml でエスケープされている場合に、その xmlThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. 自体DataSetは xml 要素名で無効な xml 文字をエスケープするだけであるため、同じを使用することはできません。The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. XML 要素名に有効な文字がエスケープされている場合、要素は処理中に無視されます。When legal characters in XML element name are escaped, the element is ignored while processing.

こちらもご覧ください

ReadXml(TextReader)

指定した DataTable を使用して、XML スキーマとデータを 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);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

パラメーター

reader
TextReader

データを読み込むために使用する TextReaderThe TextReader that will be used to read the data.

戻り値

データを読み込むために使用する XmlReadModeThe XmlReadMode used to read the data.

次の例ではDataTable 、2つの列と10個の行を含むを作成します。The following example creates a DataTable containing two columns and ten rows. この例ではDataTableWriteXmlメソッドを呼び出すことによって、スキーマとデータをメモリストリームに書き込みます。The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. 次の例ではDataTable 、2番ReadXml目のを作成し、メソッドを呼び出してスキーマとデータを格納します。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

注釈

現在DataTableのとその子孫は、指定TextReaderされたのデータと共に読み込まれます。The current DataTable and its descendents are loaded with the data from the supplied TextReader. このメソッドの動作は、 DataSet.ReadXmlメソッドの動作と同じですが、この場合は、現在のテーブルとその子孫に対してのみデータが読み込まれる点が異なります。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.

メソッドは、データのみ、またはデータとスキーマDataTableの両方をReadXmlSchema XML ドキュメントからに読み取る方法を提供します。一方、メソッドはスキーマのみを読み取ります。 ReadXmlThe 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.

メソッドWriteXmlWriteXmlSchemaメソッドについても同じことに注意してください。Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. XML データ、またはのDataTableスキーマとデータの両方を書き込むには、 WriteXmlメソッドを使用します。To write XML data, or both schema and data from the DataTable, use the WriteXml method. スキーマだけを書き込むには、 WriteXmlSchemaメソッドを使用します。To write just the schema, use the WriteXmlSchema method.

注意

InvalidOperationException読み込みまたは書き込みを行うDataRow IDynamicMetaObjectProvider内の列の型がを実装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.

インラインスキーマが指定されている場合は、データを読み込む前に、インラインスキーマを使用して既存のリレーショナル構造が拡張されます。If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. 競合がある場合 (たとえば、同じテーブル内の同じ列が異なるデータ型で定義されている場合)、例外が発生します。If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

インラインスキーマが指定されていない場合、XML ドキュメントの構造に従って、必要に応じて、推論によってリレーショナル構造が拡張されます。If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。If the schema cannot be extended through inference in order to expose all data, an exception is raised.

注意

DataSet 、xml 要素とそれに対応するDataColumnに関連DataTable付けられていないか、または ("") のような有効な xml 文字がシリアル化された xml でエスケープされている場合に、その xmlThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. 自体DataSetは xml 要素名で無効な xml 文字をエスケープするだけであるため、同じを使用することはできません。The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. XML 要素名に有効な文字がエスケープされている場合、要素は処理中に無視されます。When legal characters in XML element name are escaped, the element is ignored while processing.

こちらもご覧ください

ReadXml(String)

指定したファイルから、XML スキーマとデータを DataTable に読み込みます。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

パラメーター

fileName
String

データの読み取り元のファイルの名前。The name of the file from which to read the data.

戻り値

データを読み込むために使用する XmlReadModeThe XmlReadMode used to read the data.

次の例ではDataTable 、2つの列と10個の行を含むを作成します。The following example creates a DataTable containing two columns and ten rows. この例ではDataTable 、スキーマとデータをディスクに書き込みます。The example writes the DataTable schema and data to disk. 次の例ではDataTable 、2番ReadXml目のを作成し、メソッドを呼び出してスキーマとデータを格納します。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

注釈

現在DataTableのとその子孫は、指定Stringされたにあるという名前のファイルのデータと共に読み込まれます。The current DataTable and its descendents are loaded with the data from the file named in the supplied String. このメソッドの動作は、 DataSet.ReadXmlメソッドの動作と同じですが、この場合は、現在のテーブルとその子孫に対してのみデータが読み込まれる点が異なります。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.

メソッドは、データのみ、またはデータとスキーマDataTableの両方をReadXmlSchema XML ドキュメントからに読み取る方法を提供します。一方、メソッドはスキーマのみを読み取ります。 ReadXmlThe 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.

メソッドWriteXmlWriteXmlSchemaメソッドについても同じことに注意してください。Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. XML データ、またはのDataTableスキーマとデータの両方を書き込むには、 WriteXmlメソッドを使用します。To write XML data, or both schema and data from the DataTable, use the WriteXml method. スキーマだけを書き込むには、 WriteXmlSchemaメソッドを使用します。To write just the schema, use the WriteXmlSchema method.

注意

InvalidOperationException読み込みまたは書き込みを行うDataRow IDynamicMetaObjectProvider内の列の型がを実装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.

インラインスキーマが指定されている場合は、データを読み込む前に、インラインスキーマを使用して既存のリレーショナル構造が拡張されます。If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. 競合がある場合 (たとえば、同じテーブル内の同じ列が異なるデータ型で定義されている場合)、例外が発生します。If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

インラインスキーマが指定されていない場合、XML ドキュメントの構造に従って、必要に応じて、推論によってリレーショナル構造が拡張されます。If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。If the schema cannot be extended through inference in order to expose all data, an exception is raised.

注意

DataSet 、xml 要素とそれに対応するDataColumnに関連DataTable付けられていないか、または ("") のような有効な xml 文字がシリアル化された xml でエスケープされている場合に、その xmlThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. 自体DataSetは xml 要素名で無効な xml 文字をエスケープするだけであるため、同じを使用することはできません。The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. XML 要素名に有効な文字がエスケープされている場合、要素は処理中に無視されます。When legal characters in XML element name are escaped, the element is ignored while processing.

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");  
   }  
}  

こちらもご覧ください

ReadXml(XmlReader)

指定した DataTable を使用して、XML スキーマとデータを 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);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

パラメーター

reader
XmlReader

データを読み込むために使用する XmlReaderThe XmlReader that will be used to read the data.

戻り値

データを読み込むために使用する XmlReadModeThe XmlReadMode used to read the data.

次の例ではDataTable 、2つの列と10個の行を含むを作成します。The following example creates a DataTable containing two columns and ten rows. この例ではDataTableXmlReaderにスキーマとデータを書き込みます。The example writes the DataTable schema and data to an XmlReader. 次の例ではDataTable 、2番ReadXml目のを作成し、メソッドを呼び出してXmlReader 、インスタンスのスキーマとデータを格納します。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

注釈

現在DataTableのとその子孫は、指定XmlReaderされたにあるという名前のファイルのデータと共に読み込まれます。The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. このメソッドの動作は、 ReadXmlメソッドの動作と同じですが、この場合は、現在のテーブルとその子孫に対してのみデータが読み込まれる点が異なります。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.

メソッドは、データのみ、またはデータとスキーマDataTableの両方をReadXmlSchema XML ドキュメントからに読み取る方法を提供します。一方、メソッドはスキーマのみを読み取ります。 ReadXmlThe 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.

メソッドWriteXmlWriteXmlSchemaメソッドについても同じことに注意してください。Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. XML データ、またはのDataTableスキーマとデータの両方を書き込むには、 WriteXmlメソッドを使用します。To write XML data, or both schema and data from the DataTable, use the WriteXml method. スキーマだけを書き込むには、 WriteXmlSchemaメソッドを使用します。To write just the schema, use the WriteXmlSchema method.

注意

InvalidOperationException読み込みまたは書き込みを行うDataRow IDynamicMetaObjectProvider内の列の型がを実装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.

インラインスキーマが指定されている場合は、データを読み込む前に、インラインスキーマを使用して既存のリレーショナル構造が拡張されます。If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. 競合がある場合 (たとえば、同じテーブル内の同じ列が異なるデータ型で定義されている場合)、例外が発生します。If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

インラインスキーマが指定されていない場合、XML ドキュメントの構造に従って、必要に応じて、推論によってリレーショナル構造が拡張されます。If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。If the schema cannot be extended through inference in order to expose all data, an exception is raised.

注意

DataSet 、xml 要素とそれに対応するDataColumnに関連DataTable付けられていないか、または ("") のような有効な xml 文字がシリアル化された xml でエスケープされている場合に、その xmlThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. 自体DataSetは xml 要素名で無効な xml 文字をエスケープするだけであるため、同じを使用することはできません。The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. XML 要素名に有効な文字がエスケープされている場合、要素は処理中に無視されます。When legal characters in XML element name are escaped, the element is ignored while processing.

こちらもご覧ください

適用対象