DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml Method

Definition

Liest ein XML-Schema und XML-Daten in das DataSet.Reads XML schema and data into the DataSet.

Überlädt

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen XmlReader das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Liest mit der angegebenen Datei und im angegebenen DataSet das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen Stream das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen TextReader das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das DataSet.Reads XML schema and data into the DataSet using the specified file.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die TextReader.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die Stream.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die XmlReader.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen XmlReader das XML-Schema und die XML-Daten in das 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);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode

Parameter

reader
XmlReader XmlReader XmlReader XmlReader

Der XmlReader, aus dem gelesen werden soll.The XmlReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Einer der XmlReadMode-Werte.One of the XmlReadMode values.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet einen targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten ReadXml , wenn aufgerufen DataSet wird, um das mit XML zu laden, das Elemente ohne qualifizierenden Namespace enthält.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Liest mit der angegebenen Datei und im angegebenen DataSet das XML-Schema und die XML-Daten in das 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

Parameter

fileName
String String String String

Der Name der Datei, aus der gelesen werden soll, einschließlich des Pfades.The filename (including the path) from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Einer der XmlReadMode-Werte.One of the XmlReadMode values.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Ausnahmen

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet einen targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten ReadXml , wenn aufgerufen DataSet wird, um das mit XML zu laden, das Elemente ohne qualifizierenden Namespace enthält.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugehörige Enumeration:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Siehe auch

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen Stream das XML-Schema und die XML-Daten in das 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);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode

Parameter

stream
Stream Stream Stream Stream

Der Stream, aus dem gelesen werden soll.The Stream from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Einer der XmlReadMode-Werte.One of the XmlReadMode values.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Das gleiche gilt für die WriteXml und WriteXmlSchema Methoden bzw..Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.The same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Wenn Sie verwenden ReadXml und Sie auf XmlReadMode Diffgramfestlegen, kann sich der Inhalt des DataSet Ziels und des DataSet Originals aufgrund der Art und Weise, wie das DiffGram-Array generiert und verarbeitet wird, unterscheiden.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. Weitere Informationen zu DiffGrams finden Sie unter DiffGrams.For more information on diffgrams, see DiffGrams.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet eine targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und DataSet beim Aufrufen ReadXml von wird möglicherweise eine Ausnahme ausgelöst.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Liest mit dem angegebenen DataSet und im angegebenen TextReader das XML-Schema und die XML-Daten in das 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);
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode

Parameter

reader
TextReader TextReader TextReader TextReader

Der TextReader, aus dem gelesen werden soll.The TextReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Einer der XmlReadMode-Werte.One of the XmlReadMode values.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet eine targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und DataSet beim Aufrufen ReadXml von wird möglicherweise eine Ausnahme ausgelöst.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das 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

Parameter

fileName
String String String String

Der Name der Datei, aus der gelesen werden soll, einschließlich des Pfades.The filename (including the path) from which to read.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Ausnahmen

Beispiele

Im folgenden Beispiel wird zuerst eine einfache DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Das DataSet Schema und die Daten werden durch Aufrufen der WriteXml -Methode auf den Datenträger geschrieben.The DataSet schema and data are written to disk by invoking the WriteXml method. Eine zweite DataSet wird erstellt, und ReadXml die-Methode wird verwendet, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet einen targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten ReadXml , wenn aufgerufen DataSet wird, um das mit XML zu laden, das Elemente ohne qualifizierenden Namespace enthält.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugehörige Enumeration:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Siehe auch

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die 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);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

Parameter

reader
TextReader TextReader TextReader TextReader

Der TextReader, aus dem das Schema und die Daten gelesen werden sollen.The TextReader from which to read the schema and data.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird zuerst eine einfache DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Das DataSet Schema und die Daten werden durch Aufrufen der WriteXml -Methode auf den Datenträger geschrieben.The DataSet schema and data are written to disk by invoking the WriteXml method. Eine zweite DataSet wird erstellt, und ReadXml die-Methode wird verwendet, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet eine targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und DataSet beim Aufrufen ReadXml von wird möglicherweise eine Ausnahme ausgelöst.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Klassen, die von der TextReader -Klasse erben StreamReader , StringReader enthalten die Klassen und.Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die 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);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Parameter

stream
Stream Stream Stream Stream

Ein von Stream abgeleitetes Objekt.An object that derives from Stream.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird zuerst eine einfache DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Das DataSet Schema und die Daten werden durch Aufrufen der WriteXml -Methode auf den Datenträger geschrieben.The DataSet schema and data are written to disk by invoking the WriteXml method. Eine zweite DataSet wird erstellt, und ReadXml die-Methode wird verwendet, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet eine targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und DataSet beim Aufrufen ReadXml von wird möglicherweise eine Ausnahme ausgelöst.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. Wenn Sie nicht qualifizierte Elemente lesen elementFormDefault möchten, legen Sie im XML-Schema den Wert "qualified" fest, wie im folgenden Beispiel veranschaulicht.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>  

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die 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);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parameter

reader
XmlReader XmlReader XmlReader XmlReader

Der XmlReader, aus dem gelesen werden soll.The XmlReader from which to read.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird zuerst eine einfache DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Das DataSet Schema und die Daten werden durch Aufrufen der WriteXml -Methode auf den Datenträger geschrieben.The DataSet schema and data are written to disk by invoking the WriteXml method. Eine zweite DataSet wird erstellt, und ReadXml die-Methode wird verwendet, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataSet aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Um Schemas und Daten zu lesen, verwenden Sie eine der der ReadXML Überladungen, die enthält die mode Parameter, und legen Sie dessen Wert auf ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataSet, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.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. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Wenn das XML-Schema für DataSet einen targetNamespaceenthält, werden die Daten möglicherweise nicht gelesen, und es können Ausnahmen auftreten ReadXml , wenn aufgerufen DataSet wird, um das mit XML zu laden, das Elemente ohne qualifizierenden Namespace enthält.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. Um nicht qualifizierte Elemente zu lesen elementFormDefault , legen Sie im XML-Schema auf "qualified" fest, wie im folgenden Beispiel veranschaulicht.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 erbt von XmlReader.System.Xml.XmlTextReader inherits from XmlReader.

Hinweis

Wenn DataSet das Schema für die Elemente mit demselben Namen, aber unterschiedlichen Typs im gleichen Namespace enthält, wird eine Ausnahme ausgelöst, wenn Sie versuchen, das Schema DataSet mit ReadXml zu lesen, indem Sie angeben 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. Diese Ausnahme tritt nicht auf, wenn Sie .NET Framework Version 1,0 verwenden.This exception does not occur if you are using .NET Framework version 1.0.

Siehe auch

Gilt für: