DataSet.ReadXml メソッド

定義

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

オーバーロード

ReadXml(XmlReader, XmlReadMode)

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

ReadXml(String, XmlReadMode)

指定したファイルと DataSet を使用して、XML スキーマとデータを XmlReadMode に読み込みます。Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode)

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

ReadXml(TextReader, XmlReadMode)

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

ReadXml(String)

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

ReadXml(TextReader)

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

ReadXml(Stream)

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

ReadXml(XmlReader)

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

ReadXml(XmlReader, XmlReadMode)

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

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

パラメーター

reader
XmlReader

読み取り元の XmlReaderThe XmlReader from which to read.

mode
XmlReadMode

XmlReadMode 値のいずれか 1 つ。One of the XmlReadMode values.

戻り値

XmlReadMode

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

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマにが含まれている場合 DataSet targetNamespace 、データが読み取られない可能性があり、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml でを読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(String, XmlReadMode)

指定したファイルと DataSet を使用して、XML スキーマとデータを XmlReadMode に読み込みます。Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (string fileName, System.Data.XmlReadMode mode);
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String, mode As XmlReadMode) As XmlReadMode

パラメーター

fileName
String

読み込み元の (パスを含む) ファイル名。The filename (including the path) from which to read.

mode
XmlReadMode

XmlReadMode 値のいずれか 1 つ。One of the XmlReadMode values.

戻り値

XmlReadMode

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

例外

FileIOPermissionRead に設定されていません。FileIOPermission is not set to Read.

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマにが含まれている場合 DataSet targetNamespace 、データが読み取られない可能性があり、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml でを読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(Stream, XmlReadMode)

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

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

パラメーター

stream
Stream

読み取り元の StreamThe Stream from which to read.

mode
XmlReadMode

XmlReadMode 値のいずれか 1 つ。One of the XmlReadMode values.

戻り値

XmlReadMode

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

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

を使用し、 ReadXml をに設定した場合 XmlReadMode Diffgram 、diffgram の DataSet 生成および処理方法によって、ターゲットと元のコンテンツが DataSet 異なる場合があります。When you use ReadXml and you set XmlReadMode to Diffgram, the content of the target DataSet and the original DataSet may differ because of how the diffgram is generated and processed. Diffgram の詳細については、「 diffgram」を参照してください。For more information on diffgrams, see DiffGrams.

注意

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.

の XML スキーマに DataSet が含まれている場合 targetNamespace 、データが読み取られない可能性があります。また、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml を読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(TextReader, XmlReadMode)

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

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

パラメーター

reader
TextReader

読み取り元の TextReaderThe TextReader from which to read.

mode
XmlReadMode

XmlReadMode 値のいずれか 1 つ。One of the XmlReadMode values.

戻り値

XmlReadMode

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

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマに DataSet が含まれている場合 targetNamespace 、データが読み取られない可能性があります。また、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml を読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(String)

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

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
member this.ReadXml : string -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String) As XmlReadMode

パラメーター

fileName
String

読み込み元の (パスを含む) ファイル名。The filename (including the path) from which to read.

戻り値

XmlReadMode

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

例外

FileIOPermissionRead に設定されていません。FileIOPermission is not set to Read.

次の例では、まず、 DataSet 1 つ DataTable 、2つの列、および10行の単純なを作成します。The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. DataSetスキーマとデータは、メソッドを呼び出すことによってディスクに書き込まれ WriteXml ます。The DataSet schema and data are written to disk by invoking the WriteXml method. 2番目のが作成され、 DataSet ReadXml メソッドを使用してスキーマとデータを格納します。A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithStreamReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

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

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the schema and data to an XML file.
    string xmlFilename = "XmlDocument.xml";

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename);

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the schema and data to an XML file.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename)

    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename)

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        Dim row As DataRow
        For Each row In  table.Rows
            Dim column As DataColumn
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                    row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマにが含まれている場合 DataSet targetNamespace 、データが読み取られない可能性があり、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml でを読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(TextReader)

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

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader);
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 from which to read the schema and data.

戻り値

XmlReadMode

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

次の例では、まず、 DataSet 1 つ DataTable 、2つの列、および10行の単純なを作成します。The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. DataSetスキーマとデータは、メソッドを呼び出すことによってディスクに書き込まれ WriteXml ます。The DataSet schema and data are written to disk by invoking the WriteXml method. 2番目のが作成され、 DataSet ReadXml メソッドを使用してスキーマとデータを格納します。A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマに DataSet が含まれている場合 targetNamespace 、データが読み取られない可能性があります。また、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml を読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

クラスを継承するクラスには、クラス TextReader StreamReader とクラスが含ま StringReader れます。Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(Stream)

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

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);
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 から派生するオブジェクト。An object that derives from Stream.

戻り値

XmlReadMode

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

次の例では、まず、 DataSet 1 つ DataTable 、2つの列、および10行の単純なを作成します。The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. DataSetスキーマとデータは、メソッドを呼び出すことによってディスクに書き込まれ WriteXml ます。The DataSet schema and data are written to disk by invoking the WriteXml method. 2番目のが作成され、 DataSet ReadXml メソッドを使用してスキーマとデータを格納します。A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマに DataSet が含まれている場合 targetNamespace 、データが読み取られない可能性があります。また、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml を読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマでを "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema, as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象

ReadXml(XmlReader)

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

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader);
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 from which to read.

戻り値

XmlReadMode

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

次の例では、まず、 DataSet 1 つ DataTable 、2つの列、および10行の単純なを作成します。The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. DataSetスキーマとデータは、メソッドを呼び出すことによってディスクに書き込まれ WriteXml ます。The DataSet schema and data are written to disk by invoking the WriteXml method. 2番目のが作成され、 DataSet ReadXml メソッドを使用してスキーマとデータを格納します。A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithXMLReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

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

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the XML schema and data to file with FileStream.
    string xmlFilename = "XmlDocument.xml";

    // Create FileStream
    System.IO.FileStream fsWriteXml =
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Create an XmlTextWriter to write the file.
    System.Xml.XmlTextWriter xmlWriter =
        new System.Xml.XmlTextWriter
        (fsWriteXml, System.Text.Encoding.Unicode);

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema);

    // Close the FileStream.
    fsWriteXml.Close();

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream fsReadXml =
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Open);

    // Create an XmlTextReader to read the file.
    System.Xml.XmlTextReader xmlReader =
        new System.Xml.XmlTextReader(fsReadXml);

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);

    // Close the XmlTextReader
    xmlReader.Close();

    // Print out values of each table in the DataSet
    // fusing the unction defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the XML schema and data to file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Create FileStream    
    Dim fsWriteXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter to write the file.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
        (fsWriteXml, System.Text.Encoding.Unicode)

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)

    ' Close the FileStream.
    fsWriteXml.Close()
        
    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
        
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim fsReadXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Open)

    ' Create an XmlTextReader to read the file.
    Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)

    ' Close the XmlTextReader
    xmlReader.Close()
        
    ' Print out values of each table in the DataSet using the 
    ' function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
    
 Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName)
         For Each row In  table.Rows
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())

             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub

注釈

メソッドは、 ReadXml データのみ、またはデータとスキーマの両方を XML ドキュメントからに読み取る方法を提供し DataSet ReadXmlSchema ます。一方、メソッドはスキーマのみを読み取ります。The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. データとスキーマの両方を読み取るには、パラメーターを含むオーバーロードのいずれかを使用 ReadXML mode し、その値をに設定し ReadSchema ます。To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

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

注意

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.

の XML スキーマにが含まれている場合 DataSet targetNamespace 、データが読み取られない可能性があり、を呼び出して、修飾された ReadXml DataSet 名前空間を持たない要素を含む xml でを読み込むと、例外が発生する可能性があります。If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. 修飾されていない要素を読み取るには、 elementFormDefault 次の例に示すように、XML スキーマで "qualified" に設定します。To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

System.Xml.XmlTextReader は、XmlReader から継承されます。System.Xml.XmlTextReader inherits from XmlReader.

注意

のスキーマに同じ DataSet 名前の要素が含まれていて、同じ名前空間に異なる型が含まれている場合、を指定することによってでスキーマをに読み取ろうとすると、例外がスローされ DataSet ReadXml XmlReadMode.ReadSchema ます。If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. .NET Framework バージョン1.0 を使用している場合、この例外は発生しません。This exception does not occur if you are using .NET Framework version 1.0.

こちらもご覧ください

適用対象